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ABSTRACT 


This thesis describes the potential use of a general-purpose controller autonomously 
to measure acoustic vibration in the Space Shuttle Cargo Bay during launch. The ex- 
perimental package will be housed in a Shuttle Get Away Special (GAS) canister. 

We have implemented the control functions with software written largely in the C 
programming language. We use an IBM MS DOS computer and C cross-compiler to 
generate Z-S0 assembly language code, assemble and link this code, and then transfer it 
to EPROM for use in the experiment's controller. The software is written in a modular 
fashion to permit adapung it easily to other applications. The software combines the 
experimental control functions with a menu-driven, diagnostic subsvstem to ensure that 
the software will operate in practice as it does in theory and under test. 

The experiment uses many peripheral devices controlled by the software described 
in this thesis. These devices include: a solid-state data recorder, a bubble memory 
storage module, a real-time clock, an RS-232C serial interface, a power control subsys- 
tem, a matched filter subsvstem to detect activation of the Space Shuttle's auxiliarv 
power units five minutes prior to launch, a launch detection subsystem based on 
vibrational and barometric sensors, analog-to-digital converters, and a heater subsystem. 
The matched filter design is discussed in detail in this thesis. and the results of a com- 


puter simulation of the performance of its most critical sub-circuit are presented. 
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GLOSSARY 


Analog-to-digital (A/D) Converter: Analog signals are signals whose levels vary con- 
tinuously as a function of time. Digital signals are signals which take on discrete 
(quantized) values, and these values remain constant for some given period of time, 
at which time the level is updated. An analog-to-digital converter samples a contin- 
uous input signal, decides which of a finite set of discrete values is the best one to de- 
scribe the input signal. and outputs that discrete value. A regular clock is used to 
cause the input to be sampled again on a repetitive basis, and the output likewise is 
updated at the same rate. A digital computer cannot deal with continuous signal lev- 
els, so A D converters are routinely used to let such computers read signal levels in the 
form they can handle, as digital values. 


Auxiliary Power Unit (APU): The APUS are jet-turbine-powered engines used during 
both launch and recovery to operate the control surfaces of the space shuttle. Because 
they have a limited amount of fuel. the mission will be scrubbed if they operate for 
more than seven munutes before launch. The Vibro-acoustic Experiment attempts to 
detect them. If it is successful in doing so, it can anticipate launch. 


ASCII: American Standard Code for Information Interchange. This is a seven-bit 
data code used in many digital systems to represent alphabetic and numeric characters, 
punctuation marks and a number of non-printing characters commonly used to pass 
information from one device to another. Since most digital systems are based on 
eight-bit bytes, one bit, the high-order one, is unused in the ASCII scheme. lt is not 
uncommon for manufacturers to appropriate the extra bit for their own purposes. 


BAUD: The baud rate is the number of symbols transmitted in one second. In many 
computer systems, one symbol can represent one bit (zero or one) and so the baud rate 
and the bit rate are equal. 


BCD: Binary Coded Decimal. In this format, two four-bit codes are stored in a single 
eight-bit byte. Each of these four-bit codes can take on any of ten values from 0x0 
through 0x9. Values from Оха through Oxf are forbidden. The interpretation of these 
four-bit codes is that thev represent the decimal digits from 0 through 9. Thus. a single 
eight-bit byte can represent decimal numbers from 0 through 99. This format is the 
only one used by the National Semiconductor MM58167A real time clock. 


Bubble Memory: This is a form of integrated circuit memory which uses magnetic 
domains for storing information. These domains look like bubbles when viewed under 
a microscope. hence the name. Applying magnetic fields to the bubbles causes them 
to move about, permitting the information they represent to be stored and retrieved. 
From the standpoint of a user, they generally have two chief characteristics: 


1. The data are stored in a combination of random and sequential methods. Thus 
groups of data can be accessed randomly, but the elements of the group must be 
accessed sequentially. This is analogous to the way a disk storage device oper- 
ates. It accesses tracks directly, by moving its read-write head radially over the 
disk's surface to one of a set of concentric circles. called tracks. Once the head 
is positioned over the desired track, data is sequentially read from or written to 
iL 
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2. The data they contain are non-volatile. Removing power from them does not 
destroy their contents, provided this is done in a controlled manner. This is in 
contrast to the destruction of data in typical integrated circuit memories when 
power is removed from them. Those memories are non-volatile only if a battery 
backup is available. The Intel bubble memory we are using will lose data if the 
temperature wanders outside the range [ — 20, + 75}°C [Ref. 1: Chapter 1, p.3]. 


Digital-to-analog (D/A) converters: See the earlier discussion of analog-to-digital con- 
verters for some background on the difference between analog and digital signals. The 
purpose of the digital-to-analog converter 1s to convert a digital signal to a smoothly 
varving continuous signal. Since the digital signal actually varies in jumps. it is not 
smooth to begin with. D A converters use low-pass filters to eliminate the high- 
frequency components represented by the sudden jumps of a digital signal. 


Dynamic: In the C programming language, most variables are dynamic. This means 
that they are created when a C function commences executing and are destroyed when 
that function completes executing. This is in contrast to the way szatic (q.v.) variables 
work. 


EEPROM: Electrically erasable. programmable ROM (q.v.) The contents of 
EEPROMs are not as easily modified as are the contents of RAMs. but they are 
non-volatile (they don't lose their contents when power is removed.) The contents of 
these memories can be erased electrically, but generally at a much slower rate than 
that at which they can be read. 


EPROM: Erasable. programmable ROM (q.v.). EPROM{s can be erased for re-use 
if they are exposed to ultraviolet light for several minutes. It is usual to remove the 
integrated circuit from the circuit board to do this. EPROMs have a limited lifetime 
due to wear on the pins (unless zero-insertion-force sockets are used) and because their 
ability to be erased diminishes with age. 


Executable Program Module: The output of the link process (q.v.) 1s a single file of 
machine code instructions. When placed in the computer's memory at the correct lo- 
cations (specified in advance), these instructions permit the computer to execute a 
program. 


FIFO: First-in, first-out. This term refers to a common data structure. One place 
this data structure is used is in the buffer on the bubble memorv controller. That 
bulfer serves as an intermediate storage area between the bubble memory and the user. 
For example, when data are being read from the bubble memory by the user, they are 
retrieved from the bubble memory by the bubble memory controller and placed in the 
FIFO buffer. Concurrently, data are being removed from the buffer and sent to the 
user. The first characters of information to arrive in the buffer are the first to leave, 
hence the first in are the first out. 


Firmware: This term describes the computer programs which are stored in non- 
volatile memory, such as ROM (q.v.) 


Handshaking: When two devices communicate, they employ a protocol which speci- 
fies which device does what, when. This protocol is referred to as “handshaking”. 


Hexadecimal: Numbers to the base 16. [t is customary to use the usual digits (0-9) 
as well as the letters ‘A’ (or ʻa’) through ‘F’ (or '£), for the 16 distinct symbols required 
in this system. The C programming language by convention uses the prefix ‘OX’ (or 
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"Ox) to make it clear that the appended characters represent a hexadecimal quantity. 
For example. 


246 = Ох2а = 2, х 16 + dig X с ср то 0 т =? 


Input/Output space: The Z-SO and the essentially similar NSC800 provide a separate 
set of addresses for input and output devices. Certain instructions are reserved for 
these addresses, which can run from 0x00 through Oxff. They do not interfere with the 
corresponding memory address space (q.v.) 


I/O: Input or output. 
I/O Space: See Input/Output Space. 


Latch up: A comparator will ordinarily produce a high voltage when the non- 
inverting input receives a higher voltage than that present on the inverting input. 
Similarly, it will ordinarily produce a low voltage when the non-inverting input re- 
ceives a lower voltage than that present on the inverting input. Some comparators 
are susceptible to the phenomenon called "latch up". This entails a failure of the 
comparator to change its output according to the usual rules. Instead. the output 
signal will remain stuck at one value without regard to changes at the input. This 
feature is highly undesirable. as it means that the comparator is no longer performing 
as it should. 


Library: The output of the compilation or assembly steps is an object module. Se- 
veral of these can be stored in a library for convenience. During the link process, the 
linker can look in the modules stored in the library for definitions of objects whose 
names it does not recognize. The alternative to putting modules in a library is to 
specify them individually to the linker, which is somewhat less convenient. 


Linker: The linker is responsible for combining the object modules which comprise 
a complete program. and placing them in suitable memory locations. Object modules 
mav include references to other modules or identifiers defined within other modules. 
These references must ultimately be resolved to memory addresses within the com- 
puter which will run the executable program. It is the job of the linker to perform this 
address resolution. To link a program is to request the linker to construct an execut- 
able program. and resolve all unknown addresses. The object modules may be ob- 
tained by the linker from either of two sources: from a library or from individual files 
containing only one module each. The output from the linker is a single file contain- 
ing an executable program module (q.v.) 


Memory address space: The Z-80 and the essentially similar NSC800 permit address- 
ing memory with addresses in the range 0x0000 through OxíTIÉ. Most instructions 
which use addresses, including stack instructions which do not explicitly address 
memory, use this space. There is another space of addresses called the input output 
space (q.v.) 


Module: In the C programming language, many functions may be grouped together 
in a single file of source code. These are considered to comprise a single module, for 
they are compiled as a unit and the resultant object code is stored in a single file, an 
object module /q.v.j. Similar remarks hold when the source code consists of assembly 
language instructions, rather than instructions in the C programming language. In- 
deed, this concept is applicable irrespective of the programming language used to cre- 
ate the executable program. There are several advantages to building modules in this 
fashion. Chief among them is the separation of sections of a program according to 
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their functional characteristics. This permits testing one module independent of test- 
ing any other module. It also facilitates the use of fully debugged programs for other 
applications at a later date. 


Modulo: Consider a number x and another number m, called a modulus. The number 
x taken modulo m is written x mod m and it is defined to be the least positive number 
n such that x e Kk x m-- n for some integer k. As an example, 5 mod 6 — 5 because 
0x6+ 5= 5. Similarly, 9 mod 6 = 3 because 9 = 1 х6 + 3, апі —2 mod 6 2 4 since 
—22-—1x6-44. Although we can also write —2 — —2 x 6 + 10, —2 mod 6 = 10 be- 
cause 10 is not the least positive number which can be found to satisfy the equation. 


Nibble: A nibble is a half byte. This is a typical example of humor in the computer 
business. 


NSC810A: An integrated circuit from National Semiconductor which includes two 
eight-bit ports, one six-bit port, 128 eight-bit words of RAM (q.v.) and two 16-bit bi- 
nary timers. 


Object Module: An almost-executable computer program. The reason it is not fully 
executable is that not all addresses within it have been resolved vet. nor has the linker 
established what addresses should be assigned to relocatable programs. Assemblers 
and compilers produce object modules. Linkers convert them into executable form 
by resolving the unresolved addresses and assigning all relocatable code to its final 
location. 


Parametric Registers: The Intel BPK 5V75A Four-Megabit Bubble Memory includes 
five parametric registers which must be loaded prior to attempting to perform input 
from or output to the bubble memory. Two of the five comprise the block length 
register, which defines both the number of bytes contained in a page of bubble mem- 
огу (e.g., 64), and the number of pages to be transferred from bubble memory to the 
bubble memory port or vice versa at a time. Two more specify at which of the 8,192 
pages in the bubble memory to start the transfer of data. The last. the “enable” reg- 
ister, primarily defines whether operation is to be interrupt-driven or not. 


Project G-313: This is the designation of the NASA project comprising the Vibro- 
acoustic Experiment. 


PROM: Programmable ROM (q.v.) These ROMs can be written to once by the user, 
but once written, their contents can never be modified. 


Quotation Marks: In C, double quotation marks (^ ") are used to enclose character 
strings. Internally, the C compiler always places an ASCII NUL character (its 
hexadecimal representation is 0x00) at the end of a string. Single quotation marks 
(С °) are used to enclose a single character. Internally, the C compiler does rot append 
an ASCII 0x00 to a single character. 


RAM: Random access memory. This refers primarily to memory which can be writ- 
ten to and read from repeatedly. It commonly is volatile, j.e., its contents are de- 
stroyed when power is removed. 


ROM: Read-only memory. This term is a bit of a misnomer. Obviously a memory 

which can never be written to would be of little value. Generally, it is much more 

difficult to modify the contents ofa ROM than it is to modify the contents ofa RAM. 
ROMs come in several varieties: 


ХҮШ 


1. А mask-programmed ROM receives its data at the factory according to a 
customer s specification when it is manufactured. 


ta 


A PROM (q.¥.) is programmed once by the user. 


Ge 


. An EPROM (q.r.) can be programmed repeatedly, but must be erased by ultra- 
violet light between uses. 


4. An EEPROM (q.v.) also can be programmed repeatedly, but it can be erased 
electrically. 


RS-232C Serial Interface: This interface is also known as the EJA standard interface 
It was developed in 1969 by the Electronic Industries Association in conjunction with 
the Bell svstem, as well as independent manufacturers of computers and modems. 
Data are transmitted serially using two voltage levels. + V, represents a binarv 0: 
— V, represents a binary 1. 

The voltage V, can he within the range [3.235]V. While the RS-232C defines the 
electrical characteristics of the interface, the functional description of the interchange 
circuits, and lists standard applications, it is silent on the subject of phvsical connec- 
tors. Usually, however, DB-25 connectors having 23 pins are used. The tables in 
APPENDIX I. RS2252€ INTERFACE PIN CONNECTIONS on page 224 show 
the pin connections for the RS-232C interface. [Ref. 2: p. 683] 


SSDR: Solid State Data Recorder. This device stores audio data 1n magnetic bubble 
memories. lt accepts conimands analogous to those selected bv pushing a button on 
a conventional. reei-to-reel tape recorder. For example. the commands PLAY and 
RECORD exist. However, access to the data can be random. 


Static: In C. most variables are dynamic (g.v.) They can be made static by the inclu- 
sion of this keyword in their declarations. This causes them to become permanent. 
Thev are not then created when the funcuon in which they are declared starts to exe- 
cute. Thev are created at the time of compilation. They do not lose their contents 
when that function's operation ends. The contents of the storage locations assigned 
to them remain intact until the next time that function tries to access that variable. 


UART (Universal Asynchronous Receiver-Transmitter): A common integrated circuit 
which provides asynchronous communications between two hardware devices. We use 
it to implement an RS-232C senal interface between the controller hardware and a 
terminal. 


Volatile Memory Storage: Conventional RAM (q.v.) loses its contents when power is 
removed. This property is called volatility. By contrast, magnetic core and bubble 
memories are non-volatile. For that matter, printed pages are also non-volatile 
memories. 


Voltage Controlled Oscillator (VCO): The VCO operates a loudspeaker in the exper- 
iment during the sweep phase. The frequencies are increased incrementally between 
35 Hz and 785 Hz in 1 Hz increments. 
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I. INTRODUCTION 


Since it began flying into space in April, 1981 the Space Shuttle has made it much 
easier to get payloads into space. Although the shuttle was grounded because of the 
tragic explosion of the Challenger on January 28, 1986, flights resumed in October, 1988. 


A. GET AWAY SPECIAL (GAS) 

In 1976 the National Aeronautics and Space Administration (NASA) established the 
Get Away Special (GAS) program [Ref. 3: p.11]. The purpose of this program is to 
permit individual experimenters to have room on the Space Shuttle for their experiments, 
provided there is no undue interference with the rest of the mission as a result. To pre- 
clude such interference. NASA therefore imposes a number of constraints on these ex- 


periments. Among these are 


1. They must contain their own power source, heating. data handling facilities, and 
so on [Ref. 4: p.$]. 


2. No more than three external switches may be provided for operation by crew 
members. Of these. one must be devoted to removing all power from the payload 
[Ref. 4: p. 2$). 

The Space Shuttle is subject to powerful acoustic vibrations during launch. In the 
past. minor breakage of crystals and circuit boards has resulted [Ref. 3: p.11]. It is 
thought that the vibrations are responsible for this damage, and that some regions of the 
cargo bay are more susceptible to damage than others. Acoustical analysis of the sound 
waves which cause these vibrations could reveal where the best and worst locations are. 

Several early GAS experiments carried conventional reel-to-reel tape recorders and 
were intended to record the acoustic waves in the cargo bay for subsequent analvsis. 


However, the analysis was flawed for several reasons [Ref. 5: p. 15]. Among these were: 


I. The microphones were mounted close to the bulkhead of the cargo bay, within a 
partial enclosure. Thus the data might have been erroneous. 


2. The data recorded by the microphone may have been contaminated by interaction 
between the microphone and its isolation system. 


3. The acoustical waves in the forward third of the cargo bay were not recorded. 


Furthermore, astronauts were too busy at launch time personally to initiate the exper- 
iments. Instead, the experiments included circuitry to detect the roar of the main engines 


and trigger the commencement of the experiment [Ref. 6: p. 11]. There is good reason 


to doubt the validitv of the analysis of acoustic waves whose collection was itself trig- 
gered by the occurrence of those same waves. As a result of all these factors, the anal- 


ysis so far has been ambiguous. 


B. THE VIBRO-ACOUSTIC EXPERIMENT 

The Space Systems Academic Group at the Naval Postgraduate School plans to 
conduct an experiment as NASA project G-313 to obtain improved acoustical meas- 
urements in the cargo bay of the Space Shuttle during launch. [n the remainder of this 
thesis, we shall refer to this project as the Vibro-acoustic Experiment. The reader is re- 
ferred to [Ref. 7] for a general overview of the experiment. 

The purpose of this thesis is to describe the software and some of the hardware 
which controls the Vibro-acoustic Experiment. At times this thesis will merely describe 
the work we have done. At other times, it will prescribe what to do to achieve various 
ends. Thus it will serve not merely as documentation of what has been done, but it will 
also serve as a manual for those who might wish to elaborate on this earlier work. 

The majority of the work performed by the author had to do merely with the control 
of the experiment. However, the matched filter (described in Chapter III. THE 
MATCHED FILTER on page 21) was redesigned by the author and is completely de- 
scribed in this thesis. 

A great deal of the hardware and software created to control the Vibro-acoustic 
experiment is very general in nature, and would apply without change to other exper- 
iments. We will attempt to indicate which components have general applicability. The 
hope is that future applications will benefit from this approach, and will be spared the 
need to build and program a controller from scratch. More information on the 
general-purpose controller hardware we use in the Vibro-acoustic Experiment can be 
found in Chapter II. CONTROL HARDWARE on page 10. The software is described 
in general terms in Chapter IV... DESIGN OF THE CONTROL SOFTWARE on page 
43. 


C. DIFFERENCES FROM EARLIER EFFORTS 
Like earlier experiments, this one is housed in a GAS canister. It differs from them, 
however, in several key respects. 
1. Isolation of Microphones 
The experiment uses microphones housed in a mounting designed at the Naval 


Postgraduate School to isolate them from vibration. This is intended to reduce the 


contamination of the recorded acoustical waves by structural vibrations. This micro- 
phone arrangement is described in Stehle [Ref. 5]. 
2. Solid State Data Recorder (SSDR) Using Bubble Memory 
Conventional reel-to-reel tape recorders are supplanted by a recorder using 
magnetic bubble storage. This recorder was also designed at the Naval Postgraduate 


School and has the following advantages over conventional recorders. 
1. It contains no moving parts, so is less prone to mechanical failure. 


2. It permits random access to data, not possible with tape. While such a capability 
is commonplace with disk storage, disks do suffer from mechanical breakdown. 
Also, they are vulnerable to errors when external accelerations occur, as they do 
during a launch. This is less problematic in the case of bubble memories. 
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Bubble memory is non-volatile, that is, its contents are not destroyed when power 
is removed. Thus battery power is not required to keep the stored data available. 
Slightly offsetting this advantage is the fact that power must be removed in a con- 
trolled fashion, and specified temperature limits must be maintained. 
The magnetic bubble recorder is described in Frey [Ref. $]. 
3. Mlicroprocessor Control of the Experiment 

To operate the experiment, another group at the Naval Postgraduate School 
built a single-board, microprocessor-based controller. This general-purpose controller 
uses a National Semiconductor NSC800 microprocessor (roughly equivalent in function 
to a Zilog Z-$0). This controller, as it was originally conceived, is described in Wallin 
[Ref. 3]. From a programmer's standpoint, the controller has the characteristics de- 
scribed in Chapter II. Section A. Standard Controller on page 10. 

The controller will be responsible for: 

1. activating all subsystems at the appropriate time; 


2. monitoring execuuon of the experiment; 


3. keeping a log of significant events and the dates and times at which they occurred. 
This log is stored in the controller’s bubble memory module; 


4. recording temperature and voltage readings while the shuttle is in space; and 


5. ensuring that the bubble memories do not get too cold. This is done by 
intermittently operating the heater subsystem to maintain a temperature above 
MC ef. loge. 3] 

In addition to the obvious functions called for in controlling the experiment, the soft- 
ware also contains a menu-driven diagnostic subsystem to provide for testing on the 
ground. (See APPENDIX B. CHOICE OF A SOFTWARE DEVELOPMENT SYS- 


TEM on page 83 for a general description of the several software development systems 


we have used.) 


D. PROCEDURAL OUTLINE OF THE VIBRO-ACOUSTIC EXPERIMENT 

In this section we sketch an outline of the operation of the Vibro-acoustic Exper- 
iment. The flowcharts in Chapter IV, Section 2. Performing the Experiment on page 
46 show the procedure which the experiment follows. A synopsis of this procedure is 
provided here.! The experiment begins to operate when the ground crew or astronauts 
turn on a switch in the cabin, causing power to be applied to the GAS canister which 
houses the experiment. With power applied, the microprocessor comes to life. Its first 
task is to initialize the programmable hardware ports and timers. It then has to decide 
Whether or not to perform the complete experiment or an abridged version of it. The 
need for such a decision will become apparent presently. For the moment we will con- 
fine our attention to the unabridged experiment. 

1. Sweep Phase 

Once the cargo bay has been loaded, the ground crew will activate the exper- 
iment for about an hour to let it perform the sweep phase. During this phase, the cargo 
bay is irradiated with a sequence of acoustic tones of known frequencies and the acoustic 
response of the enclosure 15 recorded by the Solid State Digital Recorder (SSDR). After 
the mission, analyzing this data [Ref. 9] and comparing it to the echoes recorded during 
launch will reveal the locations of the regions most and least prone to damage from vi- 
bration. This phase is the longest, and lasts 13 minutes. 

2. Detection of the Auxiliary Power Units (APUs) 

The Space Shuttle’s Auxiliary Power Units (APUs) are jet turbines used to op- 
erate control surfaces during launch and recovery of the shuttle. The APUs start to 
operate around five minutes before launch. Because they emit a characteristic frequency 
at 600 Hz, we can use a matched filter to detect their acoustic signature 
[Ref. 6: pp. 15-18]. When the matched filter detects this signal, it knows that launch 
is imminent, and it is time to start recording the sounds which occur prior to launch. 
Thus we will record the sounds before, during, and after launch. By not waiting for the 
roar of the main rocket engines before starting to record the ambient noise, we will avoid 
the problem mentioned in Chapter I, Section A. Get Away Special (GAS) on page 1. 
The data collected by this means should be much more accurate. 


1 See Chapter IV, Section B. Operation of the Vibro-acoustic Experiment on page 45 for 
complete details. 


Since there exists the possibility that for some reason the matched filter vill fail 
to detect the APUS, the experiment includes two backup systems. 


1. Тһе Vibration-activated Launch Detector will detect the vibrations associated with 
launch. 


2. A second backup system will use two barometric pressure switches to detect the 
drop in atmospheric pressure which occurs as the Space Shuttle rises. These 
switches will be placed in a redundant, parallel configuration. Thus, if either one 
or both of them work, the drop in barometric pressure will be detected. 

Neither of these systems can detect operation of the APUs. However, if either one 
should detect a launch, the control program stops waiting for the APUs to come on and 
switches immediately to the launch phase. 

If the matched filter successfully detects the APUs but the Vibration-activated 
Launch Detector fails to detect launch, the barometric sensor will cause the experiment 
to switch to launch phase, albeit a little late. 

It would be unfortunate if the matched filter failed to detect the APUs. for then 
one of the primary advantages of the Vibro-acoustic Experiment over earlier efforts to 
record acoustical noise in the Space Shuttle would disappear. It would be doubly un- 
fortunate if neither the matched filter nor the vibration detection subsystem worked, for 
then no data would be recorded until well after launch. If anv one of the three systems 
works as designed, then the experiment will acquire at least some data. 

3. Scroll Phase 

If the matched filter detects the APUs, the control program will place the Solid 
State Data Recorder (SSDR) into scroll mode. In this mode. the SSDR uses a subset 
of its bubble memory for recording the ambient noise prior to launch. The fraction of 
memory dedicated to this purpose permits at most 110 seconds of recording time. Once 
tis memor: 1s used up. the SSDR wili start re-using it from the beginning.- .As a result 
of this mode of operation, roughly two minutes of pre-launch noise will be recorded, 
along with the noise of the ignition of the main engines. 

4. Launch Phase 

Either the vibration detection subsystem or the barometric sensors can trigger 
detection of a launch. When a launch is detected, the control program puts the SSDR 
into launch mode. The purpose of this mode is to record the noise after the launch be- 


gins. In /aunch mode, enough memory is dedicated to permit about two minutes of 


2 [n effect. the SSDR is writing onto a continuous, looped scroll, hence the name of this mode 
of operation. 


ambient noise to be recorded.3 Once this memory is exhausted, the SSDR will signal the 
control program that it has finished operations. 
S. Post-launch Operations 

After the SSDR has signalled completion, the Vibro-acoustic Experiment has 
finished gathering all the acoustical data it needs. The controller will continue, however, 
to monitor and record temperature in the GAS canister and record this information in 
its own bubble memory module. It will also monitor and record voltage levels of each 
of three power supply batteries. If these should fall below 8.5V, it will halt. This pre- 
vents loss of data in the bubble memory due to insufficient voltage and current levels. 

The basis for choosing 8.5V follows. Each individual cell is rated for 2.0V. 
There are five of these cells in the 10 V stack which powers the bubble memory. If any 
cell drops to 1.81V or below, it 1s considered to be below the operating threshold. Five 
such cells generate 9.05V. The bubble memory itself can operate on as little as 5 V. 
We know that the batteries are losing power when the voltage falls below 8.5 V, but we 
still have a margin of 3.5 V above the voltage required to operate the bubble memory. 
(The margin is reduced slightlv due to the presence of 5 V voltage regulators in the cir- 
cuit, but it 1s still ample.) It is therefore reasonable to halt operations if the voltage falls 
below 8.5V . 

Also, if the temperature of the bubble memory falls below 10°C, it is below the 
minimum operating temperature. and we will suspend operation of the bubble memory 
until the temperature returns to 10°C once more. Likewise, if the temperature should 
rise above 55°C, it is above the maximum operating temperature, and bubble memory 
operations will be suspended until the temperature drops within the operating range 
agains [Ref. 1: Chapter 1. p. 3] 

6. Abridged Experiment 

NASA has balked at the idea of our performing the sweep phase. They are 

concerned over the possibility that the loud sounds generated during the sweep might 


damage other payloads or frighten technicians. They also are reluctant to remove per- 


3 Since the shuttle's cargo bay 1s not pressurized, the air will leak out as the outside pressure 
drops. After two minutes, there will be no appreciable atmosphere left inside the cargo bay, and 
all sound will have ceased. 


4 These checks are only performed during the post-launch phase. which begins within two or 
three minutes from the time of launch. It is unlikely that NASA would launch the shuttle if the 
outside temperature were below 10°C, and we do not anticipate that the temperature will fall 
appreciably within the first three minutes of flight. 


sonnel from the vicinity of the shuttle during that phase. They are equally reluctant to 
require those personnel to wear hearing protection during the sweep. 

Those arguments seem specious to us. It strikes us as unlikely that damage to 
equipment might result from the sweep but not from the rocket motor noise during lift 
off. We cannot see the reason why personnel whose hearing might be damaged during 
the sweep cannot wear hearing protection. While we can still perform an analysis of the 
recorded data without first doing a sweep, it is likely to produce less useful results. 

We have decided to proceed as we wanted to originally, that is, to design an 
experiment which would do everything we want. We have added an additional decision 
point to permit the abridged experiment to take place. This shortened experiment would 
simply turn on the recorder when the APUs were detected or when launch occurred, and 
we would hope for the best. There would be no sweep, no scroll, and no launch phases: 
there would only be a record phase, once the APUs or a launch were detected. 

Once NASA sees that the abridged experiment works, that the analysis provides 
good results, and that permitting the unabridged experiment will vield even better data, 
we hope that they will relent and pernit us to fly the experiment again in the unabridged 
mode. 


E. IRREGULARITIES 

What happens if the power fails temporarily and then is restored? This might hap- 
pen if the power switch is inadvertently switched off by the ground or flight crew, or 
through some equipment malfunction, Upon the restoration of power. the micro- 
processor must decide where in its procedure to resume execution. There are several 


cases to consider. 


1. The sweep phase has never been initiated, nor has a launch occurred. The correct 
action is to start at the beginning. 


tJ 


The sweep phase has been initiated. [t is not known whether or not it ever was 
completed, but a launch has not occurred. The correct action is to skip the sweep 
phase and wait for some indication of a launch. The sweep creates a very loud 
noise which would be hazardous to ground personnel if it were permitted to occur 
at other than a scheduled time. Since this time is not known at present, and never 
is firmly enough known in advance to be programmed into the computer, we can- 
not risk running the sweep phase if it is interrupted by a power fault. 


3. The sweep phase has been initiated (and presumably completed), the APUS are on, 
but no indications of a launch are present. The correct action is to enter scroll 
mode. If it was already in progress when the power fault occurred, it will be re- 
started. This is all right, since no vital information will be lost by this procedure. 


4. The sweep phase has been initiated (and presumably completed) and conditions of 
a launch are present but the barometric switch has never been tripped. The correct 


action is to assume We are just beginning a launch and to initiate launch mode. 
This creates a risk that recordings of the moment of launch would be lost if a power 
fault occurred between the moment of launch and the triggering of the barometric 
switch as the spacecraft ascends. There is no obvious way entirely to eliminate this 
risk. 


5. The sweep phase was initiated (and presumably completed) and the barometric 
switches were activated at some earlier point. This implies that the power fault 
took place after the activation of the barometric switches, that is, after launch. The 
correct action is to assume that launch data was successfully recorded and to initi- 
ate the post-launch monitoring operations. 


F. OTHER APPLICATIONS 

The controller hardware is sufficiently powerful that it could easily provide control 
for other applications. In particular, many spaceborne applications could be operated 
DNE 

In the course of developing the control software, we had to create support routines 
to take care of a great many mundane functions. In computers with operating systems, 
these functions are typically provided by the operating system. The user has merely to 
know about them and use them. 

The controller we use has no operating system, so we had to create many low-level 
functions, e.g., one which converts a hexadecimal number to a character string repres- 
enting that number. 

At a higher level, we wrote subroutines to display text on a terminal, operate a 
bubble memory, operate a real-time clock. and control various external devices through 
the 44 input and output lines provided with the controller. 

By using the low-level subroutines, and by organizing an application’s software in 
a sinular manner, much of the most tedious and uninspiring work entailed in producing 
a control program for this controller hardware could be avoided. This would leave more 
time to devote to the real purpose of the application. In an environment with few people 
available to do the work, such economy is very attractive. 

Another consideration is the lack of a need to use assembly language in program- 
ming the controller. In the very few places where it was required, we used it. Along 
with the large collection of C language subroutines of general applicability, the routines 
we have already provided in assembly language should suffice for almost all run-of-the- 
mill work. 

In one area we were ourselves compelled to abandon the use of C language source 
code and switch to assembly language code. We initially hoped that only the start-up 


code, the input routine, the output routine and the software delay routine would require 


the use of assembly code. We assumed we could input from and output to the bubble 
memory using compiled C language source code. 

This assumption turned out to be incorrect. We needed a data transfer rate of 
16,000 bytes per second [Ref. 1: Chapter 1, p. 3], but could only attain around 3,000 
bytes per second. Consequently, we had to replace a small section of C code with as- 
sembly language source code. Even this was necessary only because we used a prototype 
bubble memory board with a buffer whose size was inadequate to handle data transfers. 
While this buffer provided only 40 characters of space, we needed 64. 

When speed becomes paramount, assembly code may be necessary, since it can be 
tailored to the job at hand and so produce very efficient programs.5 For many applica- 
uons, however, speed is not critical. It ordinarily is foolish to waste time achieving in 
assembly language what can be done much more quickly using a high-level language. 
Only if you cannor achieve the desired performance with a high-level language. must you 
use assembly language. 

Irrespective of whether some portion of an application does or does not demand 
efficient code (written in assembly language), for most applications the majority of the 
code can be written in a high-level language such as C. Many applications, too, need 
no more facilities than those provided in the Vibro-acoustic Experiment. In such cases, 


building on the work presented in this thesis has very clear advantages. 


5 Nonetheless, some optimizing compilers surpass quite competent assembly language pro- 
grammers in efficiency. 


П. CONTROL HARDWARE 


The controller we use in the Vibro-acoustic Experiment is based on the NSC800 
microprocessor. For all practical purposes, this is functionally equivalent to the Zilog 
Z-806 [Ref. 10]. Figure 1 on page 11 is a block diagram showing the major components 
of the system. To the left of the microprocessor appear those peripherals which ordi- 
narily fall under the control of the standard controller. We discuss these peripherals and 
their capabilities in Section A. Standard Controller below. One can connect an assort- 
ment of devices to the 44 input and output lines available on it. Other applications than 
the Vibro-acoustic experiment could use this bare-bones controller for their own pur- 
poses. 

To the right of the microprocessor appear those peripherals which are peculiar to 
the Vibro-acoustic Experiment. We discuss these peripherals and their capabilities in 


Section B. Additional Controller Hardware on page 14 below. 


À. STANDARD CONTROLLER 
1. NSC$810A RAM-I/O-Timers 

Two NSCSIOA RAM-I O-Timer units provide four eight-bit ports and two six- 
bit ports. These provide 44 bits of input and output capability. There also are two 
timers on each device. One of each pair is completely independent of the data ports; the 
other, if used, reduces the number of available pins in the six-bit port to three. We have 
configured the svstem such that one of the latter kind of timer is unavailable. since we 
have dedicated the data lines with which it interferes to other purposes. The two timers 
which do not conflict with anv data lines at all are dedicated to providing: 


1. А 153.6 KHz signal to the 1M6402 Universal Asynchronous Receiver Transmitter 
(CART) where it is divided by 16 to yield a 9600 BAUD clock for serial data 
transmission. 


2. A 614.4 kHz clock which is provided to the ADC0816 Analog-to-Digital Converter. 


Thus one of the four timers is available for other uses. 
We shall hereafter refer to the two devices as NSC810A £1 and NSC810A £2 
respectively. The NSC810A reference manual [Ref. 11] refers to the eight-bit ports by 


6 The NSC800 includes several instructions not included with the Z-80. Since the Z-80 is the 
better-known device, we have not used any of the added instructions. 
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the letters A and B, and to the six-bit port by the letter C. In the rest of this thesis, when 
we wish to distinguish between ports on NSC810A z1 and NSCSIOA #2, we shall ap- 
pend a subscript to the port's letter, e.g., A, is NSC810A #1, port A. 

NSCS$10A &l uses port addresses 0x00 through Ox19.7 NSC810A #2 uses port 
addresses 0x20 through 0x39.8 

General information on programming the NSC810A can be found in [Ref. 11]. 
We present the specific manner in which these devices have been programmed for the 
Vibro-acoustic Experiment in Section A. Major Subroutines and Functions on page 
108. 

2. On-board Analog-to-digital Converter 

An eight-bit, l6-channel. National Semiconductor ADC0816 analog-to-digital 
(A D) converter permits the monitoring of voltages and temperatures at various points 
within the experiment. [t can be mounted right on the microprocessor-based controller 
board. The device is connected starting at input output space address 0x$0. Conversion 
of an analog input to a digital number is signalled to the control program by the exist- 
ence of a | in Bit 3 ol pore Ge 

3. Bubble Memory Module for the Controller 

Devoted to the use of the controller board is a 512 KByte Intel BPK 5V75A 
Four-Megabit Bubble Memory Prototype Kit. The control program will maintain a log 
in this memory of all actions it takes during the experiment. The information will in- 
clude a code signifving the action taken, the time and date of that action, and the current 
temperature and voltage readings. 

After launch, the Vibro-acoustic Experiment is over. The control program then 
uses the log solely for the purpose of recording temperatures and voltages. 

Port address 0x40 provides access to the bubble memory. There are 8192 pages 


of 64 bytes per page. Pages of the bubble memory can be specified at random by num- 


7 The term “port” is somewhat ambiguous. The NSC810A reference manual [Ref. 11] refers 
to a collection of pins within an NSC810A integrated circuit as a port. This particular device 
contains three ports: A, B and C. In common parlance, however, the term port refers to a par- 
ticular address in the input-output address space (I,O space) of the Z-80. This space spans ad- 
dresses from 0x00 through Oxff. We might say, for example. that we perform an input operation 
from port Oxla. This ts equivalent to saying we input a byte (character) from I O space address 
Oxla. We shall seldom attempt explicitly to state which use is intended. The meaning may gener- 
ally be ascertained from the context. 


8 See the discussion on hexadecimal notation in the Glossary. 
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bers from 0 through 8191. Port address 0x41 provides control information for this 
memory device. 

The bubble memory's reset line should be brought low by placing a 0 in bit 5 
of port C; before applying power to or removing power from the bubble memory. It is 
important to wait at least 50 ms after applying power before attempting to initialize the 
bubble memory (Ref. 1: Chapter 4, p. 3]. 

Power can then be applied to the bubble memory by putting a | in bit 4 of port 
C,. Putting a 0 there removes power. 

Details of the operation of this memory and the meaning of the control byte 
information are in [Ref. 1]. We describe the manner in which we have programmed the 
bubble memory to support the Vibro-acoustic Experiment in Section A. Major Sub- 
routines and Functions on page 108. 

4. Real Time Clock 

A National Semiconductor MM5$8167A real time clock makes it possible to re- 
cord in the log of events the dates and times of all actions taken. We also use this device 
to limit the amount of time the control program waits for various events to occur. If the 
event does nor occur for some reason, the control program decides to stop waiting. 

For example, once the Auxiliary Power Units (APUs) are detected, there is a 
window of about seven minutes in length. If launch does not occur within this window, 
the launch will be scrubbed since the APLUs will no longer have sufficient fuel. We can 
therefore regard the experiment as having been aborted if this amount of time passes 
without a launch. We use the real-time clock to detect the passage of this period of time. 

5. RS-232C Serial Input/Output Port 

An RS-252C interface provides communication with a serial device such as a 
terminal. This makes it feasible to monitor and control the svstem on the ground. By 
connecting a terminal to this interface, the user has access to an extensive, menu-driven 
diagnostic subsvstem. (This menu subsystem is dormant if there is no terminal at- 
tached.) No intelligence currently is required on the part of the terminal: it is purely a 
display device.9 Port address OxeO holds control information to and from the serial de- 
vice. Port address OxcO funnels data either to or from the device. Table 1 on page 14 


shows the use of the bits of the control port. 


9 Mr. David Rigmaiden of the Space Systems Academic Group at the Naval Postgraduate 
School has proposed encoding the diagnostic messages and using an intelligent terminal to display 
the corresponding human-readable messages. However, no one has yet done any work on this. 


If there is a terminal connected to the RS-232C Serial port at addresses Oxco 
and OxeQ, then bit 3 of port C, will bea I. This permits the control program to distin- 
guish diagnostic operation on the ground (when there will be a terminal attached) from 
actual performance of the experiment (when there will not be a terminal attached.) As 
can be seen in Figure 1 on page 11, the Vibro-acoustic Experiment will not use a ter- 


minal when it is in space. 


Table 1. ASSIGNMENT OF BITS IN THE RS-232C SERIAL INTERFACE 
PORT: This port uses address OxOe for control information and Ox0c for 
data. 


Direction of 
ов | Data Flow 
ET 0 if the attached device can accept output inlor- 
P mation. Il otherwise. 
1 if the attached device has data available. O oth- 
1 Input 


envise. 
B. ADDITIONAL CONTROLLER HARDWARE 


The Vibro-acoustic Experiment uses several subsvstems which are not a part of the 













standard controller. Most of these subsystems appear to the right of the microprocessor 
in the block diagram in Figure 1 on page 11. The only one which does not is the Power 
Control Subsystem, which is drawn below the microprocessor. These subsystems have 
the following functions: 

l. Analog-to-digital Converter Subsystems 

. Ihree A D converters convert the analog acoustical signal detected by a set of 

three microphones into the digital format required by the Solid State Data Recorder 
(SSDR). The design and operation of the SSDR is provided in [Ref. 9]. 

2. Solid State Data Recorder (SSDR) 

The SSDR is comparable in function to a conventional reel-to-reel tape re- 
corder. Unlike a standard tape recorder, it is not limited to sequential operation; it can 
access data randomly. The operation of the SSDR is more fully described in [Ref. 8]. 

To issue a command to the SSDR, place its code in port A, on NSCS$10A #1, 
located at I O space addresses 0x00 through 0x19. The SSDR will place a status code 


reflecting its operating state in port A,. Table 4 on page 17 defines the command codes 


Table 2. BIT ASSIGNMENTS FOR READING POWER SUBSYSTEM RELAY 
SETTINGS: The position of relays may be determined by reading port 


В, (оп NSC810A #2), which is located at I O space addresses 0x20 through 
0x39. 


Direction 
of Data Value Meaning 
Flow 
Not used. 


Input | 1 | The Solid State Data Recorder (SSDR) is on 
| 0  |TheSSDRis off. 


Input ed x A Bs Voltage Controlled Oscillator (VCO) is off. 
ТЕ ТЕТЕ. ьо о al 


E Analog to Digital Conversion (A D) cir- 
E cuit is on. 
lt is off. 
EH Matched Filter . Vibration-activated 
1 Launch detector, and Barometric Pressure 
nput а аге оп. 
рея 


heater circuit is on.‏ ل س 


N- 









































for the SSDR. Table 5 on page 17 defines the status codes the SSDR can return to the 
control program. The following SSDR commands are of particular note: 


Sweep Record 12.5 minutes of pre-determined frequencies emitted by the Voltage 
Controlled Oscillator (VCO) prior to launch. 


Scroll Record up to 55 seconds of ambient noise during the five minutes or so 
between the time the Auxiliary Power Units (APUs) come on and the time 
of launch. In this mode, the SSDR will continually re-use the same portion 
of SSDR memory. There are two sections of memory devoted to this pur- 
pose, and use alternates between them. Each can hold up to 55 seconds of 
ambient noise. When the SSDR is commanded to enter launch mode, the 
memory section currently in use will be filled and then the SSDR will switch 
over to that section of memory devoted to recording post-launch noise. 


Launch The experiment’s control program orders the SSDR to enter launch mode 
as soon as the Space Shuttle launches. This mode lasts for two minutes, 
which is about the time it takes to evacuate the air from inside the 
shuttle's cargo bay. During this mode, the SSDR records ambient noise. 
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Table 3. BIT ASSIGNMENTS FOR CONTROLLING POWER SUBSYSTEM 
RELAYS: Relays may be controlled through port B, (on NSCSIOA #1), 
which is located at I O space addresses 0x00 through 0x19. 


Direction 
of Data Value Meaning 
Flow 
Turn on the relays specified in the other bit 
ouis positions. 
В Turn off the relays specified in the other bit 
positions. 
l Operate the Solid State Data Recorder 
(SSDR). 
Output 
Do not operate the Solid State Data Recorder 
(SSDR). 










1 Operate the Voltage Controlled Oscillator 
(VCO). 
Output = 
Do not operate the Voltage Controlled 
Oscillator (VCO). 
Operate the Analog to Digital Conversion 
Output eer 
Do not operate the Analog to Digital Conver- 
sion (A D) circuit. 


l Operate the Matched Filter (including 
2 Output accelerometer and barometric switch). 
WIIIXIII II Do not operate the Matched Filter. 


(A D) circuit. 

















í | Select the heater circuit. 
Output 
RU Do not select it. 





As can be seen in the flowchart in Figure 22 on page 50, most of the experiment 
is devoted to the operation of the SSDR, that is, to placing it in the mode appropriate 
for the current phase of the Space Shuttle's mission. 

3. Matched Filter 

As mentioned in Section 2. Detection of the Auxiliary Power Units (APUs) 
on page 4, a matched filter will detect the characteristic 600 Hz signature of the APUs. 
This device will place a 1 in bit 0 of port C, if a detection occurs. Normally it leaves a 
O there. Table 6 on page 18 shows the uses of all the bits of Port C,. The matched filter 
is described in Chapter Ill. THE MATCHED FILTER on page 21. 


Table 4. SSDR COMMAND CODES: Commands are issued by writing them to 
port .4, on NSC810 =1, located at I O space addresses 0x00 through 0x19. 


STANDBY 0x01 Commands the SSDR to cease all operations and 
await further commands. 


Commands the SSDR to enter sweep mode. 
Enough memory is available for holding holding 
12.5 minutes of noise generated bv the VCO. 


Commands the SSDR to enter scroll mode. 
SCROLL 0x04 Enough memory is available for holding 30 sec- 
onds of ambient noise. 


Commands the SSDR to enter /aunch mode. 
Enough memory is available for holding two 
minutes of ambient noise. 

















SWEEP 0x02 


















LAUNCH 0х08 


B 


Table 5. SSDRSTATUS CODES: Status codes may be obtained by reading them 
from port .4; on NSCS810 =2. located at I O space addresses 0x20 through 
ONSI 


Commands the SSDR to start recording noise. 
This is analagous to the RECORD button on 
conventional tape recorders. 







Commands the SSDR to play recorded data back. 
This mode is analogous to the PLAY button on 
conventional tape recorders. 


Code Value Meaning 


OPCOMP | 0x40 Shows that the SSDR has completed the last 
command it received. 


NORMOP | 0XSÓ Shows that the SSDR is operating normally. 





4. Voltage Controlled Oscillator (VCO) 

The purpose of the VCO is to irradiate the shuttle's cargo bay with sound of a 
predetermined frequency during the sweep phase. This is done by applying power to a 
loudspeaker. The VCO is designed to step up in frequency from 35 Hz through 785 Hz 
in | Hz steps. By recording the echoes, subsequent analysis will permit a comparison 
of the acoustical response of the pure tone to that of the noise generated during launch. 

5. Vibration-activated Launch Detector 
This circuit is mounted on the same circuit board as the matched filter. Its 


purpose is to enable the control program to detect a launch, and so enable it to com- 
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Table 6. BIT ASSIGNMENTS IN PORT C, OF NSCSIOA #1 


Direction 
of Data Value Nleaning 
Flow 


Detection of the Auxiliary Power Units (APUs) 
has occurred. 

Detection of the Auxiliary Power Units (APUs) 
has not occurred. 


The Vibration-activated Launch Detector has 
detected a launch. 


0 The Vibration-activated Launch Detector has 
not detected a launch. 
One of the barometric pressure switches has 
detected a launch. 


Neither barometric pressure switch has de- 
tected a launch. 


£v No terminal is connected to the port. 
Input 


Input 


A terminal 1s connected to the RS-232C serial 
SS ae port. 


Order the power subsystem to change the 

states of the relays specified in the command 
Output at port B, 

ООЛО not change the states of the relavs. 


Not used. 





mand the Solid State Data Recorder to enter launch mode. It will set bit 1 of port C, 
high when it detects a launch (see Table 6 on page 18). Even if the matched filter never 
detects the APUs, detection of launch will still cause the control program to force the 
SSDR into launch mode. 
6. Barometric pressure switches 

On the same circuit board as the matched filter there are two barometric pres- 
sure switches connected in a redundant, parallel configuration. These switches serve as 
a backup for the Vibration-activated Launch Detector. Either one of them will place a 
high voltage in bit 2 of port C, (see Table 6) when pressure drops below 27.9 inches of 
mercury. This pressure corresponds to an altitude between 1500 feet and 2000 feet when 


the lowest barometric pressures on record at Cape Canaveral are present. In general, 


Table 7. BIT ASSIGNMENTS IN PORT C, OF NSCS8I0A #2 


Direction 
of Data Value Meaning 
Flow 


ETT Operate the heater subsystem. 
Output 
CN Do not operate the heater subsvstem. 


Not used. 



















Not used. 


Analog to digital conversion is complete. This 

refers to the On-board A D Converter (see 
Input Figure 20 on page 48). 

Analog to digital conversion is not yet com- 

plete. 


OUT E | Apply power to the bubble memory. 
ы Do not apply power to the bubble memory. 


Do not apply a reset signal to the bubble 
memory. This is the normal setting. 



























Apply a reset signal to the bubble memory. 
This must be done while power is applied to 
or removed from it. Once the power has been 
switched on or off, the reset line can be re- 
turned to 0. 


Output 


the corresponding altitude will be somewhat higher than this since barometric pressures 


will generally not be at their lowest when NASA launches a Space Shuttle. 
7. Heater Circuit 
The purpose of the heaters is to maintain the temperature of the controller's 
bubble memory module at or above 10°C during operation, and above —20°C otherwise. 
To do this, there are heater strips attached to the bubble memory module. To turn on 
the heaters, the control program places a 1 in bit 0 of port C,. It puts a 0 there to turn 
them off. Insufficient power is available to heat all the bubble memories in the Solid 
State Data Recorder (SSDR). If the contents of the log are saved, however, it should 
at least be possible to ascertain the c.use of the loss of acoustic data in the SSDR. 
8. Power Control Subsystem 
Three batteries of dry cells, each powering a different bus, provide power to the 
experiment. Partly in order to conserve power, but also to permit isolation of subsys- 


tems if an overheat condition occurs, most subsystems receive power only when neces- 


sary. The power subsystem includes a relay for each of these other subsystems. Ву 
writing appropriate commands to port DB, we can turn power to the relays on or off. 
Table 2 on page 15 shows the uses of the pins of port B, for this purpose. By reading 
a status byte from Port B, we can ascertain the position of each relay. Table 3 on page 
16 shows the uses of the pins of port B, for this purpose. 

Let us designate as relay, the relay controlled by pin i of port B,.10 Valid relays 
are relay, through relay. 

There is no relay, since bit O of port B, has a special purpose. If bit 0 of Port 
B, is a 1, then eligible relays will be switched on. If bit 0 of Port B, is a 0, then eligible 
relavs will be switched off Placing a 1 in bit i of Port B, makes relay, eligible for 
switching. Finding a 1 in bit i of port B, means relay, is on. 

Once we have issued a command to alter the position of one of the relays, we 
place a 1 in bit 4 of port C, for 20 ms to permit the command to take effect, then put a 
0 in that bit. 


10 Note that pin i of port B, refers to the same relay as does pin i of port B,. 
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HI. THE MATCHED FILTER 


This chapter describes the design of a filter whose purpose is to detect the presence 
of the 600 Hz tone characteristic of the space shuttle's Auxiliary Power Unit (APU). 
This circuit has not yet been built and tested, but the most critical sub-circuit, the 
bandpass filter it uses, has been simulated. The results of the simulation match the 
predicted performance very closelv and are included in this chapter. 

The existence of the tone and the equation of a fourth-order elliptical (Cauer) 
bandpass filter for detecting its presence are documented in Jordan [Ref. 6]. While the 
thrust of Jordan's work was to develop a digital filter, the implementation described in 
this thesis uses analog electronics. This implementation has the advantage that it can 
be constructed expeditiously with readily available components and requires less elec- 
trical power. The digital implementation described by Jordan requires special hardware 
and components. In particular, the Intel 2920 Digital Signal Processor integrated circuit 
he proposed to use 1s no longer in production. Jordan does propose an analog imple- 
mentation in addition to the digital one. lt requires six operational amplifiers; the design 
proposed here requires only four, and so require less power to operate. This is important 
in this application, since power is limited. 

The term matched filter ordinarily refers to a particular kind of filter based on 
autocorrelation. However. the term has come to be applied incorrectly to the bandpass 
filter used to detect the application of power to the Auxiliary Power Unit. Rather than 
abandon the term matched filter. which has become thoroughly entrenched in the doc- 
umentation of the Vibro-acoustic experiment, this author will continue to use (nususe) 
it to denote a narrowband filter whose purpose is to respond to the characteristic 
600 Hz tone emitted by the space shuttle’s Auxiliary Power Units beginning about five 
minutes before launch. Figure 2 on page 22 is a block diagram of the author's proposed 


design for the matched filter. 


A. MICROPHONE INPUT STAGE 
The microphone input stage is shown in Figure 3 on page 23. It uses a Panasonic 
WM-063T microphone. A 620 Q resistor limits the current through the microphone to 


8 mA. The output is an AC signal superimposed on a DC bias. 
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Figure 2. Block diagram of the Matched Filter. 


B. HIGH-PASS FILTER 

Figure 4 on page 24 shows the high-pass filter which connects the microphone to 
the pre-amplifier. The purpose of this filter is to eliminate the DC bias from the micro- 
phone signal. While simple AC coupling can in principle be provided bv a capacitor 
alone, a resistor to ground must be included to provide a path for DC from the non- 
inverting lead of the pre-amplifier. Even though the input bias current of the OPATII 
operational amplifier used to implement the pre-amplifier is less than 2 pA, if this were 
neglected, charge would accumulate on the coupling capacitor and the amplifier would 
saturate. 


The cut-off frequency of the high-pass filter was set quite low, at 


= E | 
КС = 150 KQ2)(150 nF) 





Я (2) 


Since the signal of interest is well above this, at f — 600 Hz, the filter introduces no sig- 


nificant attenuation or phase shift. 
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Figure 3. The microphone input stage. 


C. PRE-AMPLIFIER 

Figure 5 on page 25 shows tlie pre-amplifier, which boosts the microphone output 
voltage by a factor of 11 (21 dB) usiug a non-inverting configuration of the OPA-111 
operational amplifier. The OPA-I11 has a verv low noise of less than 40 nV/, Hz at 
f= 100 Hz; at higher frequencies it is even lower. Thus the microphone input is boosted 
to reasonable levels without injecting significant noise into. the signal and is buffered 


prior to the bandpass filter. 


D. FOURTH-ORDER, ELLIPTICAL (CAUER), BANDPASS FILTER 

Jordan [Ref. 6: p. 45] gives an analog implementation of a fourth-order, elliptical 
(Cauer), band-pass filter. The design provided below reduces the number of operational 
amplifiers by two, from six to four. 


The coefficients of the necessary transfer function are given in [Ref. 6: p. 36] and are: 


s? + 2.9587 А 


ي 
s? + 2.4351 x 10$ + 2.7642 x 10's? + 3.3558 х 10s + 1.8991 x 10"‏ 


(3) 


The author used a computer program to find the roots of this transfer function, which 


can be rewritten as follows: 
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Figure 4. Hish-pass filter. 


(s + j4.49 x 105 — 74.49 х 107) (5 + 3.07 х 10705 – /3.07 х 10°) 
j Xs —j (4) 


س 
(s + 62 43.84 x 107)(s + 62 — 3.84 x 10) + 58.8 + 73.89 х 10 °)\х +58.8 — у3.59 х 107)‏ 


By multiplying together the terms containing complex conjugates of each other, we ob- 


tain the biquadratic representation of this function. 


s? + (3.068 x 10°)? s? 4 (4.491 x 10°)? 
my 3,586 x 10° 3.843 x 10! ^ Е 
2 Bad x 2 342 2 SSAA X 2 1 342 
Š +( 30.5 )s + (3.586 x 10°) s +( NU ) + (583 х 107) 
Each of the factors in this expression has been written in the form 
qae o? 
Du : . (6) 


2 “Ж 2 
5 +( О, j* Wp 


This is the equation of a notch filter, given by Ghausi [Ref. 12: p. 16]. 1f c, — c,, then 
the notch filter is symmetric, that is, the attenuation curve to the left and right of the 
notch frequency is symmetric about that frequency when the transfer function is plotted 
on a logarithinic frequency scale. The first factor in equation (5) has œw, < w, Conse- 
quently, this factor represents a high-pass notch filter. The magnitude of G(s) rises once 


w in s = jw exceeds w,; it levels off once w exceeds w,. By contrast, the second factor in 
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Figure 5.  Pre-amplifier. 
equation (5) has o, 7 o,. Therefore, this factor represents a low-pass notch filter. The 
magnitude of G(s) drops once w in s = jw exceeds o,: it levels off once œ exceeds w, A 
low-pass notch filter and a high-pass notch filter placed in cascade form a bandpass filter 
if suitable choices for c, and c, are made in each case. 

It can be difficult to implement cascaded filters successfully. However, the cascade 
filter is very attractive due to its simplicity, and for this reason we have employed it here. 
The design presented has been simulated and so we believe it would be quite straight- 
forward to implement it in hardware. 

The three forms of notch filter and the bandpass filter forined by cascading a low- 
pass and a high-pass notch filter are shown in Figure 9 on page 29. Three of these 
curves were calculated by computer from the factors in the transfer function given in 
equation ($). The symmetrical notch filter transfer function plotted in the figure is an 
example of what results from equation (6) when w, =w, It, too, was calculated by 
computer from the transfer function. When the high-pass notch filter is multiplied by 
(put in cascade with) the low-pass notch filter, the bandpass filter shown in the figure 
results. By using asymmetrical notch filters, as opposed to symmetrical ones, we can 
obtain high gain in the passband. In this region both notch filters have high gain and 


so reinforce one another. 
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Figure 6. Magnitude of the transfer function of the elliptical bandpass filter. 


The transfer function for equation (5) is plotted separately in Figure 6 on page 26; 
this plot, too, was generated by computer. The advantage to writing the equation for 
the elliptical band-pass filter in the forin of equation (5) is that it is a comparatively 
simple matter to implement biquadratic filter sections using operational amplifiers; by 
cascading these sections, the entire transfer function can be implemented. Again, it can 
be difficult to implement this scheme. 

Figure 7 on page 27 shows a schematic for a generalized biquadratic filter using two 
operational amplifiers. The blocks labeled with the letter "Y" represent admittances. 
The design equations for these two filter sections are derived in APPENDIX A. Deri- 
vation of Design Equations for the Matched Filter on page 71. For the high-pass notch 


filter, they are 
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Figure 7. . A generalized biquadratic filter using two operational amplifiers. 
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Figure 8. A fourth-order, elliptic bandpass filter with Q = 12: It provides 30 dB 


of attenuation outside the passband. 
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Figure 9. Notch filters: Symmetric, low-pass, and high-pass notch filters: and a 
bandpass filter formed from a low-pass and a high-pass notch filter in 


cascade. 
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ë =o: - (=) (14) 


R= | (15) 





For the high-pass notch filter, w, = 3.068 x 103, w, = 3.586 x 10° , and Q, = 30.5. Hence 


C, 
Ca 





= 8.176. (16) 


If we make the arbitrary choice C, = l0u F, then we get C, = 1.22 F , R = 27.9 Q, 
Z,= R, = 100 КО, 2, = R, = $18 KQ , and Q,R- 851 Q. Note that Z, is a resistor 
whose magnitude in ohms is the reciprocal of the magnitude of C, in farads. Similarly, 
Z,is a resistor whose magnitude in ohms is the reciprocal of the magnitude of C, in 
farads. The apparently arbitrary choice for C, was actually not random. This circuit 
must be made with components whose stability is high to minimize changes in per- 
formance due to changes in temperature. Capacitors with low temperature coefficients 
are available in polvstyrene up to values of 10 wF. Using this value for C, allows R, not 
to be too big, and A not to be too small. 


For the low-pass notch filter, the design equations are 


po E (17) 
b 
ra (18) 
Y, = Y, =— =Z; = Z, = R, (19) 
a 
1 
е г 21 
к= Ой = ОК, (21) 





t-or- > 
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(23) 


For the low-pass notch filter, «,- 4.91 x 10? rad. s, w, = 3.843 x 105 rad's, and 
Q, — 31.0. So 





8 ES (24) 
К, 

If we arbitrarily pick R,= 1 KQ, then R. = 11.4 KQ, C = 260 nF, and OR, — 31 K Q. 
Figure 8 on page 28 shows the complete bandpass filter. We have used the LF444 Quad 
Low Power JFET Input Operational Amplifier. It has an extremely low input bias cur- 
rent of 50 pA at most, and only 35 nV/, Hz noise voltage. 

We simulated the frequency response of this filter using Micro-Cap III [Ref. 13].11 
We found that it performed almost exactly as predicted. Figure 10 on page 32 is a plot 
generated by Micro-Cap III from its simulation. By comparing this plot with that gen- 
erated from the transfer function in Figure 6 on page 26, we see that the only departure 
from the predicted performance is a slight asymmetry in the ripple in the passband. 
Since we are concerned only with detection of the Auxiliary Power Units’ acoustic sig- 
nature, and not with faithful reproduction, this is not a matter for concern. The center 
of the passband and the location of the upper and lower notch frequencies are at the 
predicted frequencies. The gain in the passband also is as predicted. The simulation 
results are strong evidence of the correctness of the analysis and the feasibility of the 
design. 

The operational amplifier in the Pre-amplifier is an OPAI11. Its output impedance 
is 100 Q. The input impedance of the bandpass filter is well above 10 k{Q2 throughout 
the passband. The bandpass filter therefore does not provide a significant load on the 
Pre-amplifier, and so the simulation results can be considered to be quite accurate, even 
though they were produced with an assumption of zero output impedance from the 


Pre-amplifier. 


11 In the simulation, we used two LF442 operational amplifier packages instead of a single 
LF444 operational amplifier package. These two packages provide operational amplifiers with 
identical electrical characteristics, which justifies the substitution made. 
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Figure 10. — Frequency respouse of the simulated baudpass filter: This plot was 
obtained using Micro-Cap III [Ref. 13]. The phase response also is 
shown. It is the curve with the staircase-like appearance. The gain 
response is nearly identical with that generated by computer and shown 


in Figure 6 on page 26. 


E. ADJUSTABLE GAIN 

Figure 11 on page 33 shows how a single LF444 operational amplifier is configured 
as a non-inverting amplifier of variable voltage gain up to 28 (29 dB). The gain is to be 
adjusted so that the strongest output signal has 3 V peak-to-peak. This maximurn signal 


is that which exists when the Auxiliary Power Unit outputs its characteristic tone. 


F. FULL-WAVE RECTIFIER 
Figure 12 on page 34 shows the design of a full-wave rectifier. It converts the 600 


Hz tone admitted by the band-pass filter into a fluctuating direct current signal. This 
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Figure 11. Amplifier providing a variable voltage gain up to 28 = 28.9 dB. 


circuit is modified from an absolute value circuit provided by Jung [Ref 14: pp. 236-237]. 
It operates as follows: 

The inverting terminal of both operational amplifiers is at virtual ground. There- 
fore. on the positive cycle of the incoming signal, current passes through resistor R, to 
the inverting input of the first operational amplifier. This current is unable to enter the 
operational amplifier because of its extremely large input impedance: nor can it pass 
through diode D, , since that diode will only pass current in the other direction. Con- 
sequently, it passes through resistor R, At point a. the voltage is the negative of the 
input voltage. The same amount of current flows through resistor Ry. Resistor R, has 
only half the resistance of R, , so it draws twice the current that resistor R, can supply. 
The balance comes through resistor R, This causes the output of the second operational 
amplifier to match that of the input to the circuit. So during the positive cycle of the 
input, the input voltage is duplicated at the output. 

On the negative cycle, the two diodes serve to keep the voltage at point a at ground 
potential. This eliminates all current through resistors R, and R,. Fhe eflect is tle same 
as if the first operational amplifier were removed entirely. The second operational am- 
plifier is then in the usual configuration for inverting. The inverse of the negative input 


signal is, of course, a positive signal. 
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Figure 12. Full-wave rectifier. 
э 


In summary, whether the input is positive or negative, the output is the absolute 


value of the input. 


G. LOW-PASS FILTER 
The signal out of the rectifier has a fundamental frequency of 


2 x 600 Hz = 1200 Hz and this is superimposed on a DC voltage derived as follows: 


v(t) = V sin(2nf1) 
= l sin(ot) 


(25) 
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Figure 13. — A general second-oider, single operational amplifier, low-pass filter. 
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Figure 14. Second-order, low-pass filter. 
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The signal into the filter has a peak amplitude of 1.5 V. Application of this formula 
gives V,,=0.955 V. This is the amplitude of the strongest signal we expect to receive 
from the Auxiliary Power Unit. 

The low-pass filter which follows the rectifier is designed to have a cut-off frequency 
of f.= 5 Hz. This frequency is well below the fundamental frequency of 1200 Hz passed 
by the rectifier. As a consequence, only the average signal V,, we have just derived will 
be present at the output. 

The circuit is based on the general circuit shown in Figure 13 on page 35. The de- 
sign equations for this circuit are derived in APPENDIX A. Derivation of Design 


Equations for the Matched Filter on page 72 and are reproduced here. 
(= (27) 


1 


с л — 
Ору C G, 


In this application, we are not concerned with the phase of the signal. Therefore it is 
reasonable to seek a maximally flat transfer function. To do this, we implement a 


second-order Butterworth filter, for which 


— 


Q, = —= = 0.707. 


S 
xe 





Given our nominal cut-off frequency / = 5 Hz, we arbitrarily choose C, 2 220 nF. We 
get C, = 440 nF, and R= 102.3 KQ. Since the cut-off frequency is not critical, we can 
pick the more convenient component values C, = 470 nF and R = 100 kQ. The resultant 
cut-off frequency is £ = 4.9 Hz and Q, 2 0.731. Since the purpose of this low-pass filter 
is to find the average of the rectified 600 Hz tone, this deviation from the design pa- 
rameters is quite acceptable as the cut-off frequency still is well below the fundamental 
frequency of 1200 Hz created by full-wave rectification of the 600 Hz tone. 

The chief benefit provided by this filter is a roll-off of 40 dB/decade when 
f> f = 49 Hz. This amounts to 96 dB attenuation when f= 1200 Hz, which is ample 
to suppress the AC component in the signal out of the full-wave rectifier. Figure 14 on 


page 36 show's the component choices and circuit for the second-order low-pass filter. 
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Figure 15. Threshold detector. 


H. THRESHOLD DETECTOR 

Figure 15 on page 38 shows the design of a threshold detector. There is some evi- 
dence that other sources of 600 [17 signals that might be present simultaneously will be 
15 dB below this. The voltage which is 15 dB below 0.955 V is 0.170 V. Any signal 
which exceeds the 0.170 V threshold just derived should cause the threshold detector to 
signal that a sufficiently strong 600 Hz signal is present. Presumably this signal is from 
the Auxiliary Power Unit. The threshold detector uses an LM358 operational amplifier. 
This device requires only a single power supply and it tends not to "latch up" when 
configured as a comparator. Its output goes high (to 5 V) whenever the threshold is 


exceeded. Otherwise, its output is held low (at ground). 


1. RESETTABLE PULSE COUNTER 

Figure 16 on page 39 shows the Resettable Pulse Counter. [ts purpose is to signal 
the presence of a 600 117 signal from the Auxiliary Power Unit if it has been contin- 
uously present for 73.1s. Spurious signals with a component at f = 600 Hz may be 
present intermittently. We do not expect them to be continuously present at levels more 


than 15 dB below that of the strongest signal expected from the Auxiliary Power Unit. 
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Figure 16. Resettable Pulse Counter: ‘This circuit decides that the APUs are on 


if it gets a signal from the threshold detector for 73.1 s. 


Consequently, the Resettable Pulse Counter has the eflect of eliminating false triggering 
due to these spurious signals. 

Whenever the threshold detector indicates the presence of the 600 IIz tone charac- 
teristic of the Auxiliary Power Unit, it produces a high output. This signal is applied to 
the LOAD(L) input of the Resettable Pulse Counter. This permits the counter to begin 
marking off the pulses which arrive from the Pulse Generator, described below. Because 
the pre-load inputs A through D all are connected to ground, the counter will count from 
zero to 15, at which point its CO output will go high. Thus. the counter will permit 
sixteen pulses to arrive from the Pulse Generator before it goes high. Since the period 


of these pulses is T — 4.57 s, the output will go high if 14 x 4.57 s = 73.1 s elapses. 
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Figure 17. — Astable operation of the LM555 Tinier to generate a pulse train. 


J. PULSE GENERATOR 

This module is based on the LM535 Tuner integrated circuit. The data sheet for this 
circuit provides equations to permit choosing component values to provide the desired 
period and duty cycle. The duty cycle is not critical to tliis application. Figure 17 on 
page 40 shows the gencral configuration for astable operation, which is the mode of 


operation which produces a periodic signal. The design equations are: 


leharge = 9-693(Ry + Rg)C (30) 
latscharge 20:09 3 RS C. (31) 

Thus the total period 
КЕ ОШ айол КЕ ee (32) 
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Figure 18. Pulse Generator. 


Solving for C we get 


Tr 
OO 33 
Еа о 

and the duty cycle 
D Ra 34 
R, ,+2R, ` 


Picking R, = R, = 200 KQ provides a duty cycle D — 0.333 , which is perfectly accepta- 
ble for this non-critical parameter. 

Figure 18 shows a Pulse Generator based on this configuration. This circuit 
produces a regular stream of square pulses of period T = 4.57 s. These are used by the 
Resettable Pulse Counter to measure the amount of time when a reasonably strong 600 


Hz signal 1s present. 
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K. SUMMARY 

This completes the description of the somewhat inappropriately named matched fil- 
ter. Simulation of the bandpass filter used in the matched filter has shown that that part 
of the design is correct and feasible. The implementation and testing of the bandpass 
filter and the other components of the entire circuit remain to be done in the future. 
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IV. DESIGN OF THE CONTROL SOFTWARE 


In describing the software which operates the controller hardware, we shall adopt 
the following conventions. 

We will show variable names in bold, e.g., variable; function names in bold with 
(possibly empty) parentheses at the end,l? e.g., function(), and constants in uppercase, 
e.g., CONSTANT.13 We shall also use bold for the names of regions, described below in 
Section A. Memory Map. Development of the software for the Vibro-acoustic Exper- 
iment was done under the Microsoft Disk Operating System (MS DOS). Figure 35 on 
page $9 shows how we arranged the hierarchy of files containing the source code, object 
code. header files, ere. See APPENDIX D. HIERARCHICAL ORGANIZATION 
OF SOFTWARE FILES on page $$ for a more complete discussion of this organiza- 


tion. 


A. MEMORY MAP 

Figure 19 on page 44 shows the addresses of the ROM and RAMI in the computer. 
Our NSCS$00-based controller provides for up to eight EPROMs and RAMs in anv 
combination, each holding 8 KBytes. The wiring of the printed circuit board permits 
placing a RAM chip in any of the addresses evenly divisible by Ox2000 (e.g., OxV000, 
0x2000, 0x4000, etc.) The addition of a jumper wire permits the RAM chip to be re- 
placed bv an EPROMI. 

The NSCS00 uses the same architecture as the Z-80 [Ref. l0]. Because the Z-80 
architecture causes execution to begin at address 0x0000 whenever power is applied, it 
is necessary to install an EPROM at location 0x0000. It was therefore convenient for 
us to put all EPROMs at the low end of memory, and all RAMs at the high end. AP- 
PENDIX C. HOW THE UNIWARE SOFTWARE USES THE COMPUTER 
MEMORY on page 86 explains the way in which the Uniware C Compiler employs the 


memory. 


12 According to custom in the C programming language. 


13 In C. constants are declared using the #define directive. These are stored in vanous header 
files such as vibro.h. 
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Figure 19. Memory map of the computer: This figure shows the locations of 
ROM, RAM, and the eight software regions. The ROM and RAM 
addresses are specified by the hardware design. The addresses of the 


regions are specified by the linker. 


44 


B. OPERATION OF THE VIBRO-ACOUSTIC EXPERIMENT 
l. Menu-driven Diagnostic Program 

Some years ago the film Alien was produced. As a part of the publicity cam- 
paign attending its release was the slogan, “In space, no one can hear you scream.” 
Similarly, when the Vibro-acoustic Experiment is performed in the Space Shuttle, there 
will be no one to hear it scream, that is, to monitor the progress of the experiment. 

This is quite different from the situation on the ground, where generally there 
is a monitor attached, and there is someone monitoring execution of the program. 
Furthermore, there is a need on the ground to test components of the experimental 
package without running the experiment from start to finish. For example, we have 
found it helpful to be able to operate the bubble memory module attached to the con- 
troller hardware in a manual mode. By this means. we have debugged the software and 
ensured that it cat operate the bubble memory successfully before attempting to use it 
in Our application. 

An obvious wav to allow software to be tested on the ground but used to run 
the experunent in space would be to compile a different program for each purpose. This 
is. to put it mildly. a very inconvenient approach. Not only must two distinct programs 
be managed. but assurance that the diagnostic version works gives little assurance that 
the operational one will work. We have elected to have a single program. usable under 
all circumstances. This requires that the program be able to recognize that someone is 
monitoring it. To do this, it simply checks bit 3 of port C, to see if a terminal is con- 
nected to the RS-232C serial interface. (See Table 6 on page 18.) If there is xo terminal 
attached, the program assumes that there is no one r, nitoring execution, /e., the ex- 
perimental package might very well be in space, and so the experiment should be oper- 
ated. If there is a terminal attached, then the package cannot possibly be in space, since 
we don't intend to include a monitor in the Space Shuttle. In this case, the control 
program does not operate the experiment. Instead, it presents to the operator a series 
of menus of choices from which the operator can choose which part of the system to 
exercise. 

The menu subsystem provides the following capabilities: 


1. Software reset. This has an effect similar to that caused by removing power and 
then applving it again. 


со 


Real-time clock control. The user can set the date and time, read them, or test a 
time-out feature used to synchronize events during the experiment. 


3. Power subsystem control. Individual subsystems can be powered up or down under 
the user's control. 


4. Bubble memory control. The bubble memory used for storing a log of events per- 
formed during the experiment can be powered up or down, initialized, or tested 
under the user's control. These tests are at a very low level. Data stored in the 
bubble memory consists of character strings, and these are unformatted. The data 
are not treated as formatted log entries.14 


5. Analog-to-Digital (A/D) converter control. Any of the temperatures and voltages 
accessible through a channel of the on-board A, D converter can be read under the 
user's control. 


6. Running the experiment. This causes the Vibro-acoustic experiment to be per- 
formed. The only difference between operating the experiment under menu control 
and operating it with no terminal attached is that with a terminal, a large amount 
of diagnostic information is displayed during execution. J} ishout a terminal at- 
tached, this information is lost. The advantage to this approach is that if the ex- 
periment works on the ground, we are assured it will work in space, since essentially 
the same code is executed in both cases. 


7. Perform port input and output. This is a verv low-level test. Characters of data can 
be written to or read from a port at any address, one at a time. This is helpful in 
debugging the software. 


8. Display contents of the controller’s memory. This, too, is a very low-level routine 
useful only for debugging. 


9. Examine or change bubble memory. These routines permit the formatted contents 
of the bubble memory log to be displayed in a readable manner on the terminal. 
In addition to allowing debugging to be done, this operation pernuts the 
experiment's operation to be tailored in advance. 


Each of these menu items leads to a further menu of functions to permit the 
Operator to test all subsvstems of the experiment. These routines are discussed in detail 
in the software description contained in Section A. Major Subroutines and Functions 
on page 108. 

2. Performing the Experiment 
This section describes in detail the steps of the experiment. These steps are il- 
lustrated in the flowcharts contained in the following pages. 
a. Microprocessor Control Program 
Flowchart 0 in Figure 20 on page 48 shows the overall structure of the 
control program. The program begins executing when power is first applied to the sys- 
tem. After initializing the hardware for proper operation, it checks to see whether or 
not there is a terminal attached. If not, it proceeds on the footing that it should run the 


14 There are additional bubble memories within the Solid State Data Recorder (SSDR) which 
are not tested by these routines. 
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experiment, bypassing all the menu routines. If, on the other hand, a terminal is con- 
nected, then the program deduces that the experiment is not being run in space, where 
no terminal will be available, and so it enters the menu subsystem. The experiment 1s 
not performed unless the user specifically requests this later. 

b. Initialize Hardware 

Flowchart 1 in Figure 21 on page 49 is a more detailed look at block 1 of 
Flowchart 0 in Figure 20 on page 48. The first initialization task to be performed is to 
let the programmable input output devices know which data lines are for input and 
which are for output. There are two clocks which also must be initialized. One of these 
provides a clock signal for serial communications at 9600 baud. The other provides a 
clock for conversion of data from analog to digital form. 

c. Run the Vibro-acoustic Experiment 

Flowchart 2 is shown in Figure 22 on page 50. It is a more detailed look 
at block 2 of Flowchart 0 in Figure 20 on page 4$. 

One of its first tasks is to initialize certain variables in the software. It then 
ascertains (by consulting a record in the bubble memory) whether the full experiment 
or the abridged version is to be performed. The full experiment consists of the sweep. 
scroll, launch. and post-launch phases already described in Chapter 1. INTRODUC- 
TION on page 1. The scroll phase is omitted if the Auxiliary Power Units (APUSs) are 
not detected before the launch was detected. 

In the abridged experiment. the program initially checks to see if the 
barometric switches have been triggered, which they would have been were the Space 
Shuttle already in space. This check is done to avoid entering record phase a second 
time when the space shuttle is already aloft. Such a situation might arise after a power 
fault during lift-off; to recommence record mode would erase the acoustic data recorded 
during the launch. 

The next decision to be made is whether or not to enter record mode. 
Conceivably, the Auxiliary Power Units could be detected and the record phase entered 
at some point, but the launch might then be scrubbed. If power were not removed from 
the experiment, then the control flow would permit record mode to be commenced anew. 
Why not just start record mode again? Operating the Solid State Data Recorder with 
its bubble memories consumes considerable power. We cannot afford to waste that 
power by, in effect, continuously operating the recorder unnecessarily. The decision not 
to let this mode be begun again until at least 12 hours after the last time will prevent this 


from happening. Also, if a power fault occurred after the record phase began. we would 
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Figure 20. Flowchart 0: This is the highest level of flowchart in the hierarchy. 


Processing begins here when the controller first receives power. 


prefer to avoid interfering with the Solid State Data Recorder (SSDR), which might still 
be operating successfully in record mode. This safeguard will ensure that such interfer- 
ence does not occur. If a mission ts sciubbed, it would not be rescheduled for at least 
24 hours. The 12 hour wait is long enough to avoid interfering unduly with the SSDR 
and to preclude wasting power and is short enough to permit correct operation when the 
Jaunch is rescheduled. 

Once either the Auxiliary Power Units or any launch indication are de- 
tected, record mode can be entered. Normally, upon completion, we expect to be in 
space. In this case, control will be passed to the post-launch phase of the mission. 
Otherwise, the mission must have been aborted and the 12 hour wait begins. 

d. Initialize Software 

Flowchart 2.1 in Figure 23 on page 51 is a more detailed look at block 2.1 
of Flowchart 2 in Figure 22 on page 50. Initializing the software entails discovering 
what the current status of the experiment is. For example, this might be the first time 


power has been applied, in which case the sweep phase has not been performed yet, and 
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Figure 21. Flowchart 1: The flowchart shows the initialization of hardware and 


software at the very beginning of program execution. 


the launch has not taken place. Or perhaps the sweep was performed previously, but the 
Space Shuttle still is on the ground. This information was stored previously in the 
bubble memory log, and it must be retrieved before the controller can know what tt 
should do. 

The controller also turns off the Voltage Controlled Oscillator for safety 
reasons. Because the speaker connected to it emits such a loud tone, it would be dan- 
gcrous to allow it to operate until the controller can first sce whether it has been begun 
once before. If NASA eventually agrees to permit the sweep phase to be performed, they 
will almost certainly afford us only one opportunity to perform it. If it does not com- 
plete successfully, there is no second chance. The heater subsystem also is deactivated 
as a power-saving measure until the controller can find out exactly what to do. 

е. Do Sweep 

Flowchart 2.2 in Figure 24 on page 52 is a more detailed look at block 2.2 
of Flowchart 2 in Figure 22 on page 50. If the sweep phase ever was started before, or 
if the launch was performed previously, the sweep phase is skipped. Otherwise the con- 


troller notes in the bubble memory log that it has now started the sweep phase, which 
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Figure 22. Flowchart 2: This flowchart shows the steps entailed in both the full 


and the abridged versions of the Vibro-acoustic Experiment. 
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Figure 23. Flowchart 2,1: This flowchart shows the steps entailed in initializing 


the software when the experiment is performed. 


will ensure that it never tries to restart it. The controller now causes echoes of known 
frequencies to be recorded. 
The controller expects to be infoimed of the completion of the sweep phase. 
Ilowever, a 13 minute timcout is initiated to make sure that the controller does not wait 
forever for this information. 
J. Start Recording Response at Known Frequencies 
[iowchart 2.2.2 in Figure 25 on page 53 is a more detailed look at block 
2.2.2 of l'lowchart 2.2 in ligure 24 on page §2. It shows the steps entailed in initiating 
the sweep phase. The Analog to Digital Converter Subsystem must be turned on first, 
since the converters power the microphones which receive the acoustic signal. The 
Voltage Controlled Oscillator (VCO) can then be started, followed by the Solid State 
Data Recorder (SSDR). Starting the SSDR requires first applying power to it and then 
commanding it to enter sweep mode. 
g. Stop Recording Response at Known Frequencies 
Flowchart 2.2.4 in l'igure 26 on page 54 is a more detailed look at block 
2.2.4 of Flowchart 2.2 in Figure 24 on page 52. It shows the steps entailed in termi- 
nating the sweep phase. These steps are to remove power from three subsystems: the 
Voltage Controlled Oscillator (VCO), the Solid State Data Recorder (SSDI) and the 
Analog to Digital (A D) Converter. 
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Figure 24. Flowchart 2.2: This flowchart shows the steps entailed in performing 


the sweep phase of the experiment. 
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Figure 25.  Flowchart 2.2.2: This flowchart shows the steps entailed in initiating 
the recording of known frequencies during the sweep phase of thc ex- 


periment. 


h. Wait for APUs to Start or for Launch Indications 
Flowchart 2.3 in Figure 27 on page 55 is a more detailed look at block 2.3 
of Flowchart 2 in Figure 22 on page 50. There are two possible indications of a launch. 
One is a signal from the Vibration-activated Launch Detector circuit. The other is a 
signal from the barometric switches. If either of these is present, the flag LAUNCHED 
is asserted. Otherwise, the controller will check to see if the Auxiliary Power Units 
(APUs) have been detected. If so, the flag APUs ON is asserted. If no indications are 
present, the controller will continue looking for them indefinitely. 
i. Do Scroll 
Flowchart 2.4 in Figure 28 on page 56 is a more detailed look at block 2.4 


of Flowchart 2 in Figure 22 on page 50. It shows the steps entailed in performing the 
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Figure 26. Flowchart 2.2.4: This flowchart shows the steps entailed in stopping 
the recording of known frequencies during the sweep phase of the ex- 


periment. 


scroll phase. Power is applied to the Solid State Data Recorder (SSDR), and it is then 
commanded to enter scroll mode. 

The mission will be scrubbed if no launch occurs within seven minutes after 
the Auxiliary Power Units are started. We initiate a ten minute timeout, which is con- 
servative. [f at the end of ten minutes no launch indications have been detected, the 
program aborts; otherwise, it asserts the LAUNCHED flag. 

J. Abort 

Flowchart 2.4.4 in Figure 29 on page 57 is a more detailed look at block 
2.4.4 of Flowchart 2.4 in Figure 28 on page 56. It shows that when the mission is 
deemed to have been aborted, power is removed from all subsystems. 

k. Do Launch 

Flowchart 2.5 in Figure 30 on page 58 is a more detailed look at block 2.4 

of Flowchart 2 in Figure 22 on page 50. The flowchart shows the steps entailed in 


performing the launch phase of the experiment. The first step is to determine whether 
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Figure 27. Flowchart 2.3: This flowchart shows the steps entailed in listening for 
the Auxiliary Power Units (APUs) while simultaneously waiting for in- 


dications of a launch. 


this is necessary or not. If the launch was ever determined to have been completed in 
the past, the LAUNCH DONE will have been asserted then. In this case, it is not ap- 
propriate to perform this phase a second time and so all the blocks in this flowchart will 
be skipped. Otherwise, the Solid State Data Recorder (SSDR) ts commanded to leave 
scroll mode and enter launch mode. Within two minutes of the time of launch, there will 
no longer be any air in the Space Shuttle's cargo bay. We initiate a three minute timeout 
so that, in the cvent that the SSDR fails to signal completion of the launch phase, the 
controller will not be stuck permanently in launch mode. The controller repeatedly 
checks either for a completion signal from the SSDR or for a timeout. 
l. Check for a Completed Launch 

Flowchart 2.5.3 in ligure 31 on page 59 is a more detailed look at block 

2.5.3 of Flowchart 2.5 in Figure 30 on page $8. If the LAUNCH DONE flag ever was 
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Figure 28. Flowchart 2.4: This flowchart shows the steps entailed in performing 
the scroll phase between the time the Auxillary Power Units (APUs) 


start operating and the time that the launch ts detected. 


asserted, this block does nothing. However, if this flag was not previously asserted, the 
state of the barometric pressure switches is checked. If either of them has tripped, we 
have a positive indication of launch. It is then appropriate to set the LAUNCH DONE 
flag. 
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Figure 29. Flowchart 2.4.4: This flowchart shows what happens when an abort 


condition is detected. 


m. Do Post-launch 
Flowchart 2.6 in Figure 32 on page 60 is a more detailed look at block 2.6 
of Flowchart 2 in Figure 22 on page 50. It shows the steps entailed in performing 
post-launch functions. These are the monitoring functions required after the Space 
Shuttle has left the earth's atmosphere. The first step is to remove power from all sub- 
systems. A five minute timcout is then initiated. The effect of this is to permit system 
status to be recorded every five minutes. the heater subsystem is one of the subsystems 
which needs monitoring. A check is done to ensure that the launch has been recorded 
as complete. These two steps are repeated continually throughout cach five nunute pe- 
1iod. At the completion of that period, current values of the temperature and voltage 
at various points are read and stored in the bubble memory tog. A cheek also is made 
to see if the voltages on the buses are too low. If so, the post-launch processing ceases. 
n. Monitor Heater Subsystem Operation 
Flowchart 2.6.3 in Figure 33 on page 61 is a more detailed look at block 
2.6.3 of Flowchart 2.6 in Figure 32 on page 60. It has two branches. In one, the tem- 
perature of the experimental apparatus is sufficiently high, in which. case the heater 
subsvstein is deactivated. In the other branch, the temperature is too low and the heater 
subsystem is activated. 
o. Do Record 
Flowchart 2.7 in Figure 34 on page 62 is a more detailed look at block 2.7 
of Flowchart 2 in Figure 22 on page 50. It shows the steps entailed in putting the ex- 


periment into the record phase. These steps are, first, to put the Solid State Data Re- 
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Figure 30. Flowchart 2.5: This flowchart shows the steps entailed in perfornung 


the launch phase of the experiment. 


corder (SSDR) into the launch mode, and then to begin a 20 minute timeout, after which 
time the SSDR would have run out of memory in which to store recorded sound. The 
SSDR normally would inform the controller that it has completed operation before the 
timeout occurs. The timeout is meant to permit the controller to leave the record phase 


even if the SSDR fails to signal completion. 
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Figure 31. Flowchart 2.8.3: This flowchart shows the steps entailed in deciding 
whether or not a launch has occurred. The barometric switch is 
deemed to be the most reliable (and only convincing) indication of a 


launch. 
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Figure 32. Flowchart 2.6: This flowchart shows the steps entailed in performing 
measurements and monitoring temperatures and voltages after the ex- 


periment is complete. 
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Figure 33. Flowchart 2.6.3: This flowchart shows the steps entailed in monitor- 
“ing the temperatures of the bubble memory unit and maintaining that 


temperature above 10°C. 
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Figure 34. Flowchart 2.7: This flowchart shows the steps entailed in performing 


the record phase of the abridged experiment. 
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V. HOW TO GET THE EXPERIMENT READY FOR A LAUNCH 


This chapter explains what must be done prior to the launch of the Space Shuttle 
to ensure that the experiment is performed correctly. The current status of the exper- 
iment is stored in page 0 of the bubble memory log. By setting appropriate information 
there, we can ensure that when power next is applied to the experimental apparatus, the 
correct sequence of steps 1s performed. 

There are really two possible experiments to be performed: the unabridged exper- 
iment and the abridged one. The abridged experiment dispenses with the sweep, scroll, 
and launch phases of the experiment. replacing them with a single record phase. Which 


of these is to be run must be stored in page 0 before launch. 


A. UNABRIDGED EXPERIMENT 
Attach a terminal to the RS-232C interface and apply power to the experiment. The 


controller will present the following menu on the terminal. 


Software reset. 

Realtime clock functions. 

Power relay switching functions. 
Bubble memory test functions. 

A/D converter functions. 

Run experiment. 

Perform port I/O. 

Display contents of controller memory. 


Examine or change the data logged in the bubble memory. 


мч n ш сч їп О с со > 


Exit this menu. 
Choose option (I). The following menu will be presented next. 


Display page 0. 
Display a page of the log. 
Alter the contents of page O. 


ч Оо о > 


Exit this menu. 


Choose option (C). The following menu vill next be displayed. 
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Toggle 'sweepstarted' flag from TRUE to FALSE. 
Toggle 'launchdone' flag from TRUE to FALSE. 

Alter value of next available page from Ox12 - 18. 
Alter value of next available half page from 1 to 0. 


Toggle 'full experiment' flag from TRUE to FALSE. 
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present to permit RECORD mode to be initiated.) 


Z Exit this menu. 


The menu may not look exactly like this, inasmuch as the flags and page numbers may 
vary. The objective, however, is to set the sweepstarted flag to FALSE; the launchdone 
flag to FALSE; the value of the next available page to 1; the value of the next available 
half-page to 0; the value of the full experiment flag to TRUE. The value of the 
RECORD start time does not matter since the record phase is not performed in the 
unabridged experiment. If a value is already correct. it may be left alone. Only if it 


needs to be changed must the corresponding menu choice be made. 


B. ABRIDGED EXPERIMENT 

For the abridged experiment, follow the same steps as with the full experiment with 
the following differences. The full_experiment flag should be set to FALSE, and the 
RECORD. start, time should be set to some value at least 12 hours before launch. The 
value of the sweepstarted flag does not matter because the sweep phase 1s omitted in the 


abridged experiment. 


C. BOTH VERSIONS OF THE EXPERIMENT 

Once all the required choices have been made, the controller may be shut off and the 
terminal should be removed. The next time power is applied, the controller will discover 
that no terminal is attached, it will consult the values last stored in page 0 to see what 


it should do, and it will perform the experiment according to those values. 


Specify the 'RECORD start time' (make this at least 12 hours before the 


VI. TESTING OF THE SOFTWARE 


Every module of the software has been tested individually for correctness. The in- 
tegrated control program also has been tested exhaustively, but because the hardware 
has not yet been completely integrated, there is a limit to what could be accomplished. 
This chapter discusses how the testing has been performed and suggests further tests to 
be done once hardware integration is complete. 

The following hardware components have been completed and have been success- 
fully operated by the integrated software: 


1. Bubble memor: for the experiment's log. 


12 


Ternunal. 
Real Time Clock. 


4. On-board Analog-to-digital (A D) converter. 
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Voitage Controlled Oscillator. 


6. Power Control Subsystem. 


In addition. a preliminary design of the Solid State Data Recorder (SSDR) was tested 
by Kuebler [Ref. 9]. His tests included a demonstration that the off-board analog-to- 
digital converters associated with the SSDR functioned correctly, that the SSDR prop- 
erly stored the acoustical data provided to it by the off-board analog-to-digital 
converters, that this data could be retrived from the SSDR. and that an analvsis could 
then be performed on the data. The final version of the SSDR has not vet been com- 
pleted. and in the testing of the software described in this thesis. no attempt has been 
made to emulate its performance. However, the controller dutifully sends commands to 
it and makes repeated (unsuccessful) attempts to read its status information. It also 
notes its inability to get correct responses in the log. 

The software has been tested many times under various conditions, both with and 
without a terminal attached. A test requires the initialization of flags in page 0 of the 
bubble memory log in advance. How to do this is explained in Chapter V. HOW TO 
GET THE EXPERIMENT READY FOR A LAUNCH on page 63. There are two 


ways to end a test, depending on whether or not a terminal is attached. 
1. If there is a terminal attached, pressing CTRL Y will interrupt the experiment and 


present the highest level menu in the diagnostic subsystem. The experiment can 
be resumed by making choice 


I 


Z. Exit this menu. 
To terminate the experiment completely, make choice 
A. Software Reset. 


If there is no terminal attached, simplv remove power from the system. This is, in 
fact, how the experiment will be terminated at the end of a space flight (if the bat- 
teries last long enough.) Attaching a terminal and applying power will put the 
control program into the diagnostic subsystem. 


The results of the experiment can be evaluated by making menu choice 
Examine or change the data logged in the bubble memory. 


The following is a list of the various conditions under which the experiment has been 


tested. The conditions are listed as applying and not applying. where this is meaningful. 


All these conditions resulted in satisfactory performance by the controller. 


he 


2. 
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Terminal present; terminal absent. 

Unabridged experiment to be performed; abridged experiment to be performed. 
Sweep phase previously performed; sweep phase not previously performed. 
Launch had occurred previously; launch had not occurred previously. 


Bubble memory space exhausted during test. The controller correctly ceased trying 
to store more data and continued to operate normally without logging its actions. 
This could not be verified without the terminal attached, for with neither a terminal 
nor a bubble memory log. the controller does not generate enough outputs for 
proper verification of its performance. There is no reason to suppose that the re- 
sults would be different with the terminal removed, however. 


Temperature out of limits. Operation of the bubble memory ceased. Power was 
applied to and removed from the heater subsystem by commands to the power 
contro] subsvstem. These commands were issued bv the subprogram responsible 
for monitoring the heaters operation, namely monitor heaters(). Although the 
heater subsystem itself has not yet been completed, the associated power relays 
switched correctly. 


Detection of the Auxillary Power Units (APUs) by the Matched Filter was and was 
not emulated by toggle switch. The controller responded correctly in both cases. 


Detection of launch by the Vibration-activated Launch Detector was and was not 
emulated by toggle switch. The controller responded correctly in both cases. 


Activation of the Barometric Pressure Switches was and was not emulated by tog- 
gle switch. In the absence of activation of the barometric pressure switches, the 
presumption is that launch did not occur. The controller responded correctly in 
both cases. 


10. Power was removed abruptly at various points in the procedure and then was re- 


stored. The controller recovered in the desired manner. 
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After each test. the contents of the bubble memory log were examined to see what steps 
in the experiment had been performed. Two obvious differences were found between the 
system's behavior with and without a terminal attached. One of these was that with a 
terminal attached, the diagnostic messages issued during the performance of the exper- 
iment Were visible. The other was that with a terminal attached, the diagnostic subsys- 
tem did not get control. No other difference could be found between system behavior 
with and without a terminal attached. 

There is every reason to believe that the control program will work as well in the 
Space Shuttle as it has in the lab. The same tests should be performed again once the 
hardware is completely integrated. The only tests which have not already been done are 
those associated with the operation of the Solid State Data Recorder (SSDR). The 
interface with this device is very simple. The controller sends commands and reads sta- 
tus information. The SSDR is otherwise completely independent of the controller. We 
have already ascertained that the application of power to the SSDR through the power 
control subsystem is done correctly. We have also verified correct response to a failure 
of the SSDR to perform as expected. The only thing we have not tested is the response 
of the control program to correct responses from the SSDR. Since the response amounts 
to making a note of the correct response in the bubble memory log, we do not anticipate 
anv difficulty in this area. The ability of the controller to send commands to the SSDR 
has been tested, although the response of the SSDR to these commands cannot be 
evaluated until the final version of the SSDR is complete. 

The means of extraction of data from the bubble memory log are not very elaborate 
at this point. Data can be extracted for two experiment steps at one time by providing 
the number of the page in the bubble memory log whose contents are required. No ca- 
pability has been provided for rapid extraction of all data to, sav, a microcomputer. This 
does not pose a serious problem, but data extraction would be facilitated by providing 


subroutines to do it quickly. 
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VII. CONCLUSIONS 


The Vibro-acoustic Experiment was the first experiment produced at the Naval 
Postgraduate School for inclusion in a Space Shuttle mission. In view of the consider- 
able technical hurdles it presented, it is fair to say it has been a very ambitious project. 
It has included many disciplines, such as mechanical engineering, thermal engineering, 
digital electronics, analog electronics, acoustics, bubble memory technology, auton- 
omous computer control, software development, a matched filter for detecting an im- 
pending space shuttle launch, power control, and computer-aided design and 
manufacturing (CAD CAM ). 

This thesis has concerned itself with overall control of the experiment and with a 
description of one subsystem, the matched filter. It was not possible to do this without 
considering the experiment as a whole. From the author's personal standpoint, this has 
been very gratifving. We have used a high-level programming language to do the bulk 
of the programming of a microprocessor-based controller, thus avoiding the labor- 
intensive burden of assemblv language coding in most areas of the program. We have 
effectively integrated this code with the little assembly code required. We have written 
drivers for assorted hardware devices, such as a terminal, a bubble memorv module and 
a real-time clock, thus demonstrating the close association between hardware and the 
software which makes that hardware more than a glorified paper-weight. We have used 
structured programming techniques throughout, thus aiding the design process, as well 
as the understanding of the documentation represented in part by this thesis. We have 
created a conveniently-used software development system, making it straightforward to 
edit the source files, compile or assemble them, link the object modules, list source files 
on a printer, and place the executable file in EPROM. 

This work may benefit others who would like to implement other applications. We 
have made it possible for them quickly to get a device controller programmed and op- 
erating, since so many standard controller functions already exist. The C programming 
language is highly portable, so much of this work would apply even with a new hardware 
design, using, sav, a faster microprocessor with more memory. 

Two other projects have already benefitted from the work done here. In one, the 
experimenters plan to obtain voltage versus current for solar cells in space. In less than 


two months, the complete control program for that new application was designed and 
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tested using the same controller and much of the software we have described in this 
thesis. 

In another project now underway, the author is involved in the experimental evalu- 
ation of a thermo-acoustic refrigerator in space. The details of the experimental proce- 
dure in both these cases differ, but the overall fundamentals of control of an experiment 
are the same. Consequently, much of the software described in this thesis can be used 
without any modification. 

For anyone who wants to build a controller with modest requirements for speed and 
RAM, the controller we have used in the Vibro-acoustic Experiment would be suitable. 
By using the work described in this thesis, one can avoid the unpleasant burden of 
starting from scratch. The bubble memory module provides a further 500K bytes of 
random access, non-volatile memory for whatever purpose might be required. 


Work remaining to be done is: 


1. Design, build and test an improved controller which would operate with more 
memory and greater speed. 


гә 


Convert the existing software to run on the new controller. This would entail re- 
placing the start-up code and other machine-dependent assemblv code. and re- 
compiling the C language source code using a compiler which would generate 
machine-language code for the new target machine. Software Development Svs- 
tems. [nc.. makes C language cross-compilers which would allow most of the ex- 
isting set-up to be preserved intact. 


3. Modify the existing bubble memory drivers to permit storage of files. At the mo- 
ment. the bubble memory is regarded as a linear list of 6J-bvte chunks of memory. 
Greater usefulness would result from the provision of a file subsvstem. 


4. Produce a manual for other potential users of the software and hardware that 
would make it easy to get new applications up and running quickly. This could be 
supplemented by improved routines to facilitate the generation of executable code. 
At the moment, these routines are specific to the Vibro-acoustic Experiment in that 
they always look in the subdirectory \vibro\contrir for the fles they need. In gen- 
eral, they should permit any subdirectory to be used to hold the files. The exper- 
iment to evaluate solar cell performance used a series of files and subdirectories 
whose structure exactly mimicked the set-up described in this thesis, but no rou- 
tines have been written to set these files up automatically. 


5. Develop or acquire a software maintenance system. Such a system would provide 
better management of successive versions of the control program. It would also 
include a data dictionary to provide a definition of all variables and functions, 
along with a complete cross-reference showing every place these objects were used. 
What would the data dictionary gain us? It often happens that in the course of 
making changes, we inadvertently affect other parts of a system. The data dic- 
tionary would make it possible to find all those places and take appropriate action. 


69 


Microprocessors have now been in use for just a little over 15 years. The use of 
compiled programs to operate them is an even more recent development, since compiled 
programs generally take up more memory space than assembled programs, and abun- 
dant memory at low prices is available. There are two distinct advantages to using a 
compiler: 


1. The code is easier both to write and to understand. This makes it easier to get 
applications running, and to modify them later, even if team members change over 
a period of time. 


2. The code is much faster to create. This often makes the difference between success 
and failure, since time can be critical, particularly in an educational environment. 
Often these advantages outweigh the disadvantages: 
i. The code tends to take more memory. 


2. The code tends to execute more slowly. 


In the case of the Vibro-acoustic Experiment, these factors were of no great conse- 
quence, except as already noted in conjunction with the bubble memory module. We 
were forced to use assembly code to operate the bubble memory in order to keep up with 
the data transfer rate demanded by it. Had there been an adequate buffer in that hard- 
ware, this extra effort could have been avoided. 

In fact, this last point makes it clear that good hardware design can greatly reduce 
the effort (i.e., the costs) associated with software development. Itis hard to believe that 
the job of implementing a 64-byte buffer in hardware would be much more difficult than 
that of implementing a 40-bvte buffer. Had Intel done this, we would have been spared 
months of development difficulties, during which we did not understand the reason why 
the C code did not work. 

Finally, the use of a compiled language which is highly portable (in particular a 
compiled language such as C) can help protect the investment of time and money in 
software which is otherwise threatened as obsolete hardware is replaced by improved 
hardware. In the software industry, endless conversions from one hardware system to 
a new one seem to be a permanent nuisance. The ability to take old programs and make 
them work on new hardware simply by recompiling them 1s attractive. 

Another potentially useful step would be to implement the controller software using 
Ada, the Department of Defense compiled language now mandated for embedded soft- 


ware in all purchased systems. This would have the advantage that Ada programmers 
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are likely to become more and more numerous over time. This would help keep the work 
already done both current and useful. 
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APPENDIX A. DERIVATION OF DESIGN EQUATIONS FOR THE 
MATCHED FILTER 


This appendix presents derivations and proofs of results used elsewhere in this thesis. 


A. BIQUADRATIC FILTERS USING TWO OPERATIONAL AMPLIFIERS 

Figure 7 on page 27 shows the topology of a generalized biquadratic filter using two 
operational amplifiers. This topology is taken from Michael [Ref. 15]. In this figure, Y 
denotes an admittance (the reciprocal of an impedance). Michael gives ideal transfer 
functions in the s-domain from the node marked V, to the nodes marked lI, Va» and 
V, We will have occasion to use the first two of these. Since Michael does not provide 
derivations for these functions, they are provided below. Note that the term “ideal” 
implies the use of operational amplifiers of infinite gain. While no such operational 
amplifiers in fact exist, there do exist operational amplifiers of very large gain, and the 
approximation 1s practical in many circumstances, especially at the low frequencies used 
in the Vibro-acoustic Experiment (i.e., the 600 Hz tone from the Auxiliary Power Unit). 
For example, the open-loop gain of the LF-444 operational amphfier is more than 
60 dB at a frequency f= 600 Hz. 


From the Kirkoff current law, and referring to Figure 7 on page 27, we have 


L = I+ L (35) 
Г. = LI — L, (36) 
= - ly. (37) 


We can find the currents J, through J, by applying Ohm's law. 


I = (V, — V,)Y, (38) 
L = (V, — V) Y, (52) 
I, = (V, — V.,)Y; (40) 
[, = (V, — V,;) Y, (41) 
Ts = (V5 — Vix) Ys (42) 


L = V, Y (43) 
I, =(Viy — V;)1 (44) 
% = Vi d (45) 


By substituting these currents into equations (35) through (37), we obtain the following 


three, independent equations. 


(Vi — VY; (V; - VA)Ys - V&Y, (46) 
(Fi Р) = PHY; + (PV; – Р), (47) 
ЕЕ о (48) 


Collecting these terms vields 


Pk, + Yor Y= UY, 4+ yy Ys (49) 
3) iz zx ү; x Fa) = Г, 1, SP 796 (50) 
nae sme (51) 


In an ideal operational amplifier, the inputs have equal voltages, so we can write 


V= a= Va. Rewriting the equations with V, in place of V, and І: gives 


ШИЕ СУ beh (52) 
VY. YF + Fg) = FoF + VY, )53( 
(TY, + TH) = VY, + PY. (54) 


These equations can be readily solved by placing them in matrix form first. 


Y, 4 + Y; + Y = Y, 0 V, = Y, Vix (55) 
Y, + Y, XI Y; — Y, V, 0 


Now interchange the positions of V; and V, 


a3 


0 Y, + Y; + Y- T Y, V, Y; 
=r ++!» о r (56) 


Next we move row 3 to the top. 


=y Уш i Rh. 


Next, multiply row | by ¥,, row 3 by Y, and subtract the latter product from the 


former to generate a new row 3. 


ad Y, Y E Y, ad | V. 0 
0 М Е c s) 
0 —VY(Y, +Y. + Ya) + (Y, + Y) — Y. 1, || V, — hi 


Now multiply row 2 by [— Y4(Y; - Y- - Y) - E(Y, 0 13)]. row 3 bv (F5 9 Y; 9 %), 
and subtract the latter product from the former to generate vet another row 3. 

= Ү, Ү, + Y3 = Ү, 5 

0 Y, Eis t; + Ys = Y> Vs 

0 0 — YyYy( Y 8 Y5 + Yg) à Y;[— Y4(Ya 4 Ys Y + Yu Yit Yp] Р 

0 
= Ys Vis: 
— YyY-(Y, + Ys + ¥) = Y; — (У + У + Ya) + Yal БЕ Y] 


(59) 


From row 3, we can see that 


Vi — YyY-(Y; + Vs + Ye) — Ys[ — Yx(Y4 + Yz + Y e Y4QYi- Y9] (60) 
Vin ы к ЕЕ cee) at ee a) 


(ШКЕ К ЕК u y ara о оп UE en 


Viy — Y Y(Ys  Y9 — Y Y;Ya — Y; Y,Y4 — YjY3Y; — YyY3Yg 9 Y YyYa 9 Y; Yy Ya ` 


Many terms in the numerator and in the denominator of this expression add to zero, 


so the transfer function is 


noL R+ Yot nY: Y- YYY; 


> IE aCe (62) 
Min — YiY,(Y; + Y,) — Y,Y, Y; — Y, Y; Ya 
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И (5) _ Y, I. Ys = Y, 1-( 1, БЕ Y,) = Y, Y; Yg 


= = — v— n" —N.. 63 
Г) WA: ey.) d 





Vis) Vs) 


This completes the derivation of Ps)" To derive the transfer function VAs)’ we 
ы А MAT л IN LE a INS. 
modify equation (55) by placing the variable V, in the last position. 








—Y, ¥,+¥;,+¥% 0 ][ wv Y. 
QE Y S prp e Lys IE (64) 
a Y Ү, xi Y, = Y, V. 0 


Proceeding as before, we multiply row 3 by — Y; , row 1 by — Ү,. and subtract the 


former product from the latter to generate a new row 3. 
= Y, }, xm Y. s Y, 0 V Y; 
0 1, + Y; — Ya —},||И|=| 1, |Р. (65) 
0 мао ют) ИЕ ls 


Next multiply row 2 by [I(T + I+ Y)- Y4(Y,- Y)],row3 by (Y; Y, + Y), 


and subtract the latter product from the former to vield a new row 3. 


EH isi y Ü H 
mE n = 77 
0 0 ЛП ЫЫ Еш + 5 %) — VAR, + YI Р 7 
DE v 
= ys VIN: 


m POM ES 
From row 3 we can see that 


V. Y, Y.(Y, + 15 + Ya) — Y, Y-(Y, + Y; + Yg) + FY5(Y, + 1) (67) 
ES YyYy(Y, + Y; + Ya) + Yi Ya(Y; + Y; + Yo) — Ptah +) 





As before, many terms in both the numerator and the denominator add to zero, so 


wer УЛ ук От) 
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It is possible, using the same method illustrated in both these cases, to develop a 





transfer function We have no use for this particular funcuon in the present 


3 $ 
Vis) "NM К 
context, however, so the derivation is omitted. 

B. HIGH-PASS NOTCH FILTER 
The equation of a notch filter is given in equation (6), repeated here. 
5? + w? 


Q, ^ i 
2 p 2 
Sap i == [Sse @ 
a d 


Michael [Ref. 15] shows how to use the generalized configuration of Figure 7 on 


F(s) 


page 27 to implement this function in the case where œ, = œ, Which is the case for a 
symmetric notch filter. However, he does not show how to implement an asymmetrical 
notch filter, in which o, = o;. 

We can do so by using equation (63) and making the following choices for the 
admittances Y, through Y, 


С, (69) 
h = sC, (70) 
Y, = @ (71) 
I (72) 
y, = 0 (5) 
Y; = 5С, (74) 
G 
li —— (75) 
8 OF 
where we pick 
G 
و‎ = (76) 


апа 
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= -ofi -(2)| (77) 


Proof 





СС? 
2 2 2 b 
V, CG +5 Te О, 


CMG DE C os 
p 


2 G2 














— 7c 
E C 

i s (gy = CO. | (78) 
(e 





Using resistance values instead of conductance values in equations (76) and (77), 


we get 


(79) 





and 


77 


(80) 





C. LOW-PASS NOTCH FILTER 


To get a low-pass notch filter, we use equation (68) and pick admittances as follows: 


i = Y, ZG, (81) 

I (82) 

1; = 14 = б, (83) 

1 0 ($4) 

= a (S5) 
<p 


where we pick 


(Só) 





and 


(87) 
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G Р 
СС c ip 
E ( ý 2) i 
I a 1 EL ИШЕ CE 
ЖЕ С С T 
P 





адар 
| C | E Са G;Q. 











2 5 2 C; 
G ;Q. (88) 





s Or 
5 | 9 
gs 
Stu. 


> 


ST AT SY 
(a re 


Converting equations ($6) and ($7) to use resistances instead of conductances, we 


get the design equations 


(89) 


and 


(90) 





D. A SECOND-ORDER, LOW-PASS FILTER USING ONLY ONE 
OPERATIONAL AMPLIFIER 
Figure 14 on page 36 is the schematic of a generalized second-order, low-pass filter. 


The general equation of a low-pass biquadratic filter is given by [Ref. 12: p. 16] as 


(91) 





This transfer function can be realized by the schematic in Figure 14 on page 36 if 


we make the following choices for the components. 


1 


сш d 
and 
OQ, =. _ u—— (93) 
E R, +R, 
Proof 
I = Vos, = ER (94) 
2 
1, =(V,— Fo)sC, (95) 
А а = en pum (96) 
1 
From equation (94), 
Va = Voll + sC,R, ] (97) 
or 
И Го = Гоз, К. (98) 
Thus 
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КИ 
I; 2 (V, — Vg)sC, 4 ——— 
К, 
rl: CCR 6J] 
Wc (99) 
e 
R. i 


We can manipulate this equation to obtain the transfer function. 


Vo[ s! C, RR, + sC,R, + 1+ sC,R, ] = Viy (100) 


Vo 1 
ССРО Ку 





l 
| CORE | 


2 +R 1 
E c ECR 


101 
| ) (101) 
2 SN C C.R R. 
$ 
| S R R [ l ua 
C mide )s i 
2 
(D, 
La O 
s+[| — |+ س‎ 
ma 
If we choose R, = R, = R, then 
1 
o, = —— (102) 
R. G G, 


and 


Гс 
=> ee (103) 


To design a filter to provide desired values of c, and Q, , use the design equations 
which can easily be derived from the above equations. 
l. Pick C, arbitrarily. 
2. Let C, = 4C,@:. 


] 
Фу СС, 


3. Pre p = 


82 


APPENDIX B. CHOICE OF A SOFTWARE DEVELOPMENT SYSTEM 
A. Z-80 ASSEMBLY LANGUAGE 


The Vibro-acoustic Experiment has a fairly long history. Long before the author 
became associated with the project, two distinct choices for a software environment!5 
had already been made. Early in the project we used Z-80 assembly language for pro- 
gramming the controller. An ALTOS eight-bit microcomputer running under Digital 
Research Corporation's Control Program for Microcomputers (CP, M) was available. 
It included a Z-$0 assembler (MS0), a librarian (LIBSO) and a linker (LS0). However, 
the turnover in student personnel is rather high at any educational institution; the Naval 
Postgraduate School is no exception. Assembly language is often not the best choice for 
a project whose participants do not remain for the life of the project, since assembly 
language is not widely known. is not easy to learn. and is highly dependent on the ar- 
chitecture of the machine in which the final program is to operate. Many different ar- 
chitectures exist, and most machines have unique architectures. Even those who know 
how to program with assembly language often are averse to expending the vast amounts 


of time required to use it for any but the most trivial programs. 


B. CP/M AND TOOLWORKS C 

As a consequence of these facts, one of the early participants in the project suc- 
cessfully promoted a switch away from Z-80 assembly language to the C programming 
language. This high-level language includes powerful operators which make it easy to 
manipulate the bits within the bytes of the computer's memory, and so it can do almost 
anything that can be done in assembly language. The same ALTOS CP M system 
happened to have Toolwork’s C compiler on it, and so we used it. 

When the author joined the project, little progress had been made in actually writing 
the control program. With Captain Frank Mazur, USMC, and Captain Ron Byrnes, 
USA, the author wrote much of the control program on the ALTOS under CP, M- using 


the Toolwork's C compller. 


15 The term software environment refers to the computer, the operating system, the program- 
ming language. and all related software and hardware tools used to program a computer. The 
computer on which the development of software is done need not necessarily be the same one as 
that in which the completed program will reside and be executed. In the case of the Vibro-acoustic 
Experiment. it is not the same computer. 
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Doing so proved to be a frustrating business. The ALTOS was equipped with two 
eight-inch, single-sided, single-density, floppy diskette drives. These could contain only 
around 250 Kbytes of data. One drive had to contain a copy of the CP M operating 
system at nearly all times. The ALTOS was quite slow by present standards; it was not 
uncommon for a compilation to take five minutes. Due to the limited disk space avail- 
able, the output of the compiler (an 8080 assembly language source filel6 ) had to be 
transferred to another diskette before assembly could proceed. Assembly tvpicallv con- 
sumed a further five minutes. The library program was quite inconvenient to use, but 
once the executable modules had been loaded successfully into a library. linking was 
straightforward. This was a comparatively quick two-minute process. 

Our EPROM writing program was on an IBM-PC using Microsoft's Disk Operating 
System (MS DOS). Furthermore, that machine had only 5 1 4 inch diskettes. So we 
took our eight-inch floppies to a Zenith Z-100 that had both sizes of drives. where we 
converted the CPM file containing executable code into an MS DOS file on a 5 1 4 inch 
diskette. 

Finally, we loaded the executable program from the diskette into the 


EPROM-writing program and created the firmware. 


C. MS/DOS AND UNIWARE C 

It should not have taken us too long to tire of this agonizing procedure. In fact, it 
was over a vear before we began seriously to search for an improvement in the form of 
a cross-compiler. We wanted a C-language compiler which would operate on an IBM 
PC using MS DOS, and which would generate Z-80 object code. Several were available. 
We selected the UniWare C Compiler package from Software Development Systems. 
3110 Woodcreek Drive, Downers Grove, IL 60515. This product is a complete software 
development system. It includes a C compiler which produces Z-80 assembly code, a 
Z-80 assembler, a library manager to store object modules in a single MS DOS library 
file, a linker to convert a collection of object modules into an executable file, and a large 
collection of utility programs, useful for listing files, converting files from one format to 


another, and so on. The compiler implements the complete C language defined by 


16 The Toolwork’s C compiler generates 8080 assembly language source code. The NSC800 
on the controller board can execute Z-80 code, a subset of the NSC800 instruction set, and the 8080 
instruction set, which is itself a subset of the Z-80 instruction set. We had an assembler for Z-80 
and 8080 code. We needed two Z-80 instructions not available in the 8080 instruction set. So we 
embedded Z-80 machine code in the 8080 assembly source created by the C compiler and executed 
the resultant module with an NSC800. It really was at least as complicated as it sounds! 
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Kernighan and Ritchie [Ref. 16]. It also includes enhancements similar, but not identi- 
cal, to those proposed by the American National Standards Institute (ANSI). 

It took a little time to convert from the old to the new system, but the results were 
well worth the effort. Because the performance of the IBM System 2 Model 80 on which 
we run this system is so much greater than that of the Altos, we are able to generate a 
new version of the controller program in much less time. The use of MS DOS also has 
provided significant benefits. We have made extensive use of hierarchical file directories 
in order to group files in a logical manner. We also use MS DOS batch files to minimize 
the amount of memory work necessary to execute such programs as the compiler and 
the linker. 

The documentation supplied with the UniWare system [Ref. 17] is excellent. Unlike 
most C compilers, this one 1s not meant to produce executable code running under an 
operating system. For this reason. much of the standard library supplied with other C 
compilers is not applicable. and is not supplied. In particular, no library functions are 
provided to perform disk input or output. However. common output formatting rou- 
tines such as printf() are included. 


D. GENERATION OF FIRMWARE IN EPROM 

We use the Intel program pepp to load the completely linked program into EPROM. 
The UniWare software can create a svmbol table showing what should go where. Armed 
with this list, one can load, install, and test the new version of the program in short or- 
der. 

Details on the operation of this program are presented in Section 2. Getting the 


Executable Program into EPROM on page 146. 
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APPENDIX C. HOW THE UNIWARE SOFTWARE USES THE 
COMPUTER MEMORY 


The UniWare software regards memory as comprised of a number of named regions. 
The C compiler itself creates five of these [Ref. 17: Compiler section, p.3]. These are the 
regions code, string, const, data, and ram. There are three further software regions: 
reset, mbrkram, and stack. The purpose of each region is described below. The linker 
treats each region as a unit and places its contents in memory in contiguous storage lo- 
cations. It. decides how to do this based on instructions in the file 
\vibro\contrir\object\spec. The order in which these regions appear in memory i$ speci- 
fied in this file. and reflected both in Figure 19 on page 44, and in the order in which 


they are described here. 


reset The Z-S0 architecture specifies that the program code stored at memory 
location 0xX0000 be executed whenever the microprocessor receives power 
or a hardware reset occurs. The reset region contains an appropriate 
Start-up program. This program does the following: 


1. It initializes the stack pointer to 0x0000. Whenever an item is stored in 
the stack. the stack pointer is first decremented. Thus. the stack pointer 
will initially be decremented to OxXfIIT, the first location in the stack. and 
will continue to grow downward in memory from this point. 


t» 


It initializes the interrupt tables in such a manner that, should a spurious 
interrupt occur, the control program will restart from the beginning. It 
would be preferable to resume execution by simply returning from the 
interrupt. This would raise the unacceptable possibility, however. of an 
indefinite suspension of the execution of the program if some unpredict- 
able cause led to the problem. While restarting has the disadvantage of 
totally disrupting matters, its compelling advantage is that execution re- 
sumes from a known state, barring a complete catastrophe. 


code This region contains all program instructions generated by C and assembly 
language source code. It includes code to do the following things: 


l. Program variables must be in RAM to be altered. In the C program- 
ming language it is possible to assign initial values to these variables at 
the time a program is compiled. These values must be placed in 
EPROM, since otherwise they would be lost. One of the routines in the 
code region is invoked at start-up time to copy initialized variables from 
their permanent locations in region data in EPROM into temporary lo- 
cations in RAM. Thus in Figure 19 on page 44 region data appears in 
two locations, both in EPROM and in RAM. 
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string 


const 


data 


ram 


mbrkram 


stack 


2. The definition of the C programming language specifies that static!? and 
externall$ variables which have no initial value specified in their decla- 
rations must be initialized by the compiler to the value 0 (Ref 16: p.198]. 
One of the routines in the code region is invoked at start-up time to put 
zeros in all RAM locations in region ram. 


3. Another routine which is invoked at start-up time calls the C program 
main(). This is the highest level program in C. It calls subordinate 
routines to operate the controller and run the experiment itself. 


Whenever the compiler finds a quoted character string in the source code, 
it places it in the string region. Since strings are treated as constants, they 
can be kept in EPROM.19 


Variables declared as const are regarded by the compiler as invariant, or 
constant, so it is reasonable to place them in EPROM. 


This region contains variables whose initial values were specified at the time 
of compilation. These values are placed in EPROM by the linker so that 
they will not be lost when power is removed from the controller. However, 
variables must be in RAM when the program executes. During the start-up 
procedure, they are copied into RAM. 


This region contains variables whose initial values were not specified at the 
time of compilation. These are initialized to 0 at the time the program is 
first invoked. as specified in Kernighan and Ritchie (Ref. 16: p. 198]. 


The UniWare C compiler provides a function mbrk() to permit a program 
to request storage at run time (/.e.. dynamically). The mbrkram region 
provides mbrk() with the storage it needs. 


The program stack is located here, at the top of memory. 


The linker ensures that items within a region are stored contiguously. The compiler 


decides where to put these partitions in memory by examining a memory map provided 


in the specification file \vibro\contrir\object\spec, listed in Section A. Filename spec on 
page 150. The format of this file is described in (Ref. 17: Link Editor Section. p. 7]. 


The memory map specifies that reset be loaded at address Ox0000, that the stack 


grow down in memory from address OxffIT, that EPROM is available from addresses 
0x0000 through Ox5fIT, and that RAM is available starting from address 0xe000 through 


ох. 


17 Static variables retain their values even after the program which declared them finishes ex- 


ecuting. 


18 External variables are declared in some module other than the one in which a program using 
these variables is defined. 


19 [n general. to modify strings a programmer must first place a copy of them into a variable. 
Dynamic variables are always located in RAM, since their contents are changeable. 
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APPENDIX D. HIERARCHICAL ORGANIZATION OF SOFTWARE 
FILES 


АП the software to control the Vibro-Acoustic Experiment is located in the file hi- 
erarchy illustrated in Figure 35 on page 89. Following is a description of the contents 


of each of these subdirectories. 


A. SUBDIRECTORY \VIBRO\CONTRLR\HEADERS 

This subdirectory contains header files for the C language source code. The header 
files allow numeric constants which are used in creating the program to be specified 
symbolically. By avoiding the use of “magic” numbers in the source code, the code is 
rendered much more readily understood. The header files also contain external declara- 
tions of the functions and variables contained within a module. Whenever one module 
needs to use the functions or variables of a different module, it can obtain correct dec- 
larations of them by including the appropriate header file using the C programming 


language #include directive. 


B. SUBDIRECTORY \VIBRO\CONTRLR\CSOURCE 
This subdirectory contains C language source code for the parts of the controller 


program written in the C programming language.20 


C. SUBDIRECTORY \VIBRO\CONTRLR\ASMSOURC 

This subdirectory contains Z-80 assembly language source code. A few of the lowest 
level routines in the controller software have been written in assembly language, but only 
when there was no apparent way to write them in C (e.g.,input(), output()), or when the 
C compiler couldn’t generate code which would execute rapidly enough (e.g., bubread() 
and bubwrite()). 


D. SUBDIRECTORY \VIBRO\CONTRLR\BATCH 
This subdirectory contains a number of MS/DOS "batch" files. These contain se- 
quences of commands which make it easier to compile programs, print listings of the 


source code, link object modules, and load executable modules into EPROMs. 


20 This comprises most of the controller software. 
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Hierarchical Root 
Organization Directory 
of Soltware 


Files Vibro-acoustle 
Experiment 
Soltware 


Controller 
Soltware 


| ч 


Headers for Source Source Assembly Assembly 
C Programs Code lor C Cods for Command Listings Object 
Programs Assembler Filas Files 
Programs 





Figure 35. Hierarchical Organization of Software Files: The software files are 
grouped into several different sub-directories to facilitate finding and 


managing them. 


E. SUBDIRECTORY \VIBRO\CONTRLR\LIST 

This subdirectory contains output listings produced either by the C compiler or by 
the Z-80 assembler.2! Those created from C source code include that code in the form 
of comments to the Z-S0 assembler. They are stored in this subdirectory only as a 
matter of convenience, in order that they not clutter up the directory listing of the sub- 


directories containing the source code. 


F. SUBDIRECTORY \VIBRO\CONTRLR\OBJECT 
This subdirectory contains object modules produced either by the C compiler or by 
the Z-80 assembler. They are stored in this subdirectory only as a matter of conven- 


ience, in order that they not clutter up the subdirectories containing the source code. 


21 Those produced by the C compiler are actually assembly language listings produced by the 
Z-80 assembler. The latter is called by the C compiler. 
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This subdirectory also contains the link specification file spec. This file provides the 
linker with information needed to decide where the various regions of the program must 
be loaded. A number of global variables are set by this file at link time. 

For details on how to use a link specification file, see the discussion in 
[Ref. 17: Link Editor Section, p. 7]. 
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APPENDIX E. SUBROUTINES, IN ALPHABETICAL ORDER BY NAME 


Table 8. SUBROUTINE INDEX: This table shows the names of the MS;.DOS 


files in which each subroutine can be found. Subroutines are listed al- 
phabetically by name. 


SUBROUTINE SOURCE PURPOSE 
FILE 
Gets a character of data from the Analog- 
to-digital (A D) Converter. š 


Converts a character of raw data from the 
Analog-to-digital (4 D) Converter into an 
integer format with the more meaningful 

units of volts or degrees kelvin. 






















ad read() 









adtoint() expmnt.c 


allow ctrl interrupts() 






Permits the user to alter the contents of page 
0 of the bubble memory. This is required in 
initializing the experiment. 













Processes the special characters CTRL S and 
CTRL Y when read from the keyboard. 
CTRL S is a toggle switch. The first time it 
is pressed, the displav halts. The second time 
it is pressed. the display resumes. Subse- 
quently its function alternates between these 
two. CIRL Y invokes the diagnostic sub- 
system. 















inout.c 


















Converts an ASCII string representation of 
a hexadecimal byte into the corresponding 
hexadecimal byte. For example, the string 
"a3" 1s converted to the byte value 0xa3. 








convert.c 


q 


bad, idea to record() 


Converts a four-byte ASCII string repres- 
enting a two-byte hexadecimal word into the 
corresponding hexadecimal word. For ex- 

ample. the string “a34b” is converted to the 
word Oxa34b. 


Converts a string representing a decimal in- 
teger into the corresponding integer. This 
subroutine is from Bilofsky [Ref. 18]. 


This routine is used in the abridged exper- 
iment to prevent record mode from being re- 
started after a power fault. Without this 

safeguard, perfectly good data recorded dur- 
ing launch might be erased. 
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Checks to see if the barometric switches have 
been activated vet. [f so, launch must have 
occurred and an appropriate log entry is 

made. 

























expmnt.c 






baro switch() 
Converts a BCD byte to the corresponding 
character string representation. For exam- 


bcd asc() convert.c 
ple, 0x17 is converted to “17”. 
: | Converts a one-byte BCD number to integer 


Loads the five parametric registers in the 
bubble memory controller. Most of these 
never change. Two, however, do change of- 
ten. These two specify the page of bubble 

bpageset() bubble.c memory where transfers of data begin. Call 
this function prior to any operation per- 
fornung input from or output to the bubble 
memory to ensure the parameters are cor- 
rectlv specified. 


Displavs a menu of low-level bubble memory 
controller commands. These are useful in 
testing the bubble memory for proper oper- 
ation. 


Initializes the bubble memory prior to its 
being used. This initialization must always 
ШЫН ище: be done after power is applied and before 
input and output operations begin. 
bubio() Bonnier Performs input from and output to the bub- 
ble memory. 
Provides a menu of functions permitting the 
user to perform operations with the bubble 
memory. These operations include: 
bubmenu() bubble.c 
the status of the bubble memory. 
bub off() bubble.c Removes power from the bubble memory. 
bub on() bubble.c Applies power to the bubble memory. 












bubcmdmenu() bubble.c 


















l. applving and removing power, 


t2 


initialization, 
3. input, 

4. output and 
5. reading 
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Takes care of the actual transfer of data from 
the bubble memory to the controller memory 
during a read. This routine was written in 
assembly language in order to achieve a data 
transfer rate of 16 K bytes per second im- 
posed bv the bubble memory hardware. 


Takes care of the actual transfer of data to 
the bubble memory from the controller 
memory during a write. This routine was 
written in assembly language in order to 
achieve a data transfer rate of 16 K bytes per 
second imposed by the bubble memory 
hardware. 








< 
bubxfer() | bubrw.s 
speed, but is called in the same manner as a 
C routine. 


Checks to see whether or not there is a ter- 
checkprt() expmnt.c minal connected to the RS-232C serial inter- 
face port. 


Dates and times in the real time clock are 

stored in BCD format. This routine converts 
clockint() clock.c them to integer format to make it convenient 

to perform arithmetic with them. Thus, fu- 

ture dates and times can be computed. 

real time clock. 


Compares two clock times to see which one 
is later than the other. 























Part of the sequence of steps necessary to 
initialize the bubble memory entails trans- 
ferring the byte Oxff to the bubble memory 
40 times. This routine does this. The rou- 
tine 1s written in assembly language for 









| clockcompare0 | | clockcompare0 | оке | оке | 


кы 












Sets the current date and time in the real 
ume clock according to values specified by 
the user. 


Adds two dates and times together to 
produce a new date and time. [n pracuce, 
one uses this to calculate a future date and 
time from the current date and time and 

some desired delav (e.g., 15 minutes). 


Returns the value TRUE 1f the bubble 
memory's temperature is below the temper- 
ature given in the argument to the function, 
FALSE otherwise. 


Converts a single character to its 
hexadecimal ASCII string representation. 
For example, 0xa3 is converted to “a3”. 
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Provides a software-driven time delav in in- 
crements of 10 ms. Written in assembly 
language, but used like a C language routine 
j delay. Say ro IE ; 
delay ee Adapted from a program by Mr. David 
Rigmaiden of the Naval Postgraduate 
School. 


: а Displays the contents of page 0 in a readable 


Displays the contents of any page in the 
bubble memory in a readable format. It will 
not successfully display page 0. Use 
display_pageO() for this purpose. 


Causes the sweep phase of the experiment to 
совер be performed. 


Produces a hexadecimal and ASCII dump 
of any desired region of memorv. 


duinp_clock() Display the date and time on the terminal. 


Display the date and time on the terminal. 
This differs from dump clock() in that the 

са dock c dates and times it uses are integers, not Bi- 
narv Coded Decimal (BCD) numbers. 


— ш Sends à single character to the terminal. 


"ESSE the Vibro-acoustic Experiment to be 
performed. 


The UNIWARE compiler provides the 
standard C output routine printf() to provide 
output to the standard output device. How- 
ever, this routine requires the user to provide 
a routine fpute() to handle the output of a 
single character to any arbitrary device. We 
only support output by fputc() to the 

ш Е RS-232C terminal, so this routine is specific 
to that device. The routine will vor output 
a character if, upon checking, it finds there 
is no terminal attached to the serial interface 
port. Thus, when the experiment is operat- 
ing, calls to printf() are of no effect unless 
there is a terminal connected. 


| Inputs a string representation of a two-digit 
. hexadecimal number from the terminal and 
ethex inout.c : : 
Б 0 converts it to hexadecimal format. For ex- 
ample, “3a” is converted to Ox3a. 
Gets a four-digit hexadecimal number in 
gethexint() noate string format from the terminal and converts 
ў it to a hexadecimal word. For example, 
“3ab2” is converted to Ox3ab2. 
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display_data_page() expmnt.c 


dump() inout.c 


[ершш nm c 



















Inputs a string representation of a decimal 
. . с 1 i 1 
getint() теше integer from the terminal and coude it to 
integer format. For example, “352” is con- 
кепге to 352. 
7 .` - o а 
getpageno() e user for a page number in bubble 


get_time() Obtain a valid date and time from the user. 


inithardware() ое: the six ports on NSC$10A zl and 


Inputs a character from a port. Written in 
input() newio.s assembly language, but used like a C lan- 

E Converts an integer in the range 0 through 

int_bed convert.c š = * 


guage routine. 
Issues commands to the bubble memory 
issububemd() bubble.c 


controller and analyzes the status codes 
itoa() convert.c 


which result. In many cases, it will attempt 
Е | 


to 1ssue a command repeatedly if there is 


some failure, doing this up to a specified 
number of times. This routine is written in 
log menu() expmnt.c 
Ep 


C and is not fast enough to handle the read 
€ m 





























and write commands. Use bubread() and 
bubwrite() for these. 








Converts an integer to an ASCII string rep- 
resentation. This subroutine is from Bilofsky 
[Ref. 18]. 


Listens for the Auxiliary Power Units 
(APUs) to be activated. It also monitors the 
Vibration-activated Launch Detector and 
the Barometric Pressure Switches to see ifa 
launch has occurred without detection of the 
activation of the APUs. 















Makes entries into the event log stored in the 
bubble memory. 









Displays a menu to provide for conveniently 
changing the contents of bubble memory. 
This is essential for properly initiating the 
experiment. 








This program can see whether a character 
has been input from the keyboard without 
disturbing the input buffer. 


First C language subroutine to get control 
after start-up. Decides whether to invoke 
the menu-driven diagnostic routines or to 
run the Vibro-acoustic Experiment. 
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Implements the C language standard library 
function mbrk(). This function was provided 
with the Unirware C Compiler. 






Asks the user for an address in memory and 
the number of bytes he wants to see dis- 

plaved. It then provides a hexadecimal and 
ASCII display of the contents of the selected 
area of memorv on the terminal. 













Displays the first in a hierarchy of menus 
permitting the user to test subsystems of the 
Vibro-acoustic Experiment individually. 


Operates the heaters if the temperature of 
the bubble memory is too cold. If the tem- 
perature is too hot, it shuts the heaters off. 
Otherwise it leaves the heaters alone. 


















expmnt.c 





monitor heaters() 
Outputs a byte to a port. Written in assem- 
bly language. but used like a C language 









output() newio.s 
routine. 
iment. These functions continue until the 
Space Shuttle returns to earth. or until the 
10V bus no longer carries sufficient voltage 
for safe operation of the bubble memories. 
power. write() power.c Sends a one-byte command code to the 
= power relay subsystem. 
A menu program which let's the user read 
pwrent() power.c the status code from the power relay subsvs- 
tem or send commands to it. 
rdstatreg() bubblee Reads the status register of the bubble 
memory controller. 
record() expmnt.c Performs the record phase of the abridged 
experiment. 


portdump() Outputs a string to the terminal. 
In the latter case, the experiment stops all 
A menu routine allowing the user to set or 
rtc() clock.c 


Conducts routine monitoring of events upon 
post_launch() expmnt.c 
Operations. 
read the clock, and to test the time-out fea- 
short. experiment() AS Performs the abridged Vibro-acoustic Ex- 
3 pon periment. 










the completion of the Vibro-acoustic Exper- 
power. status() power.c Inputs the one-byte status code from the 
= power relay subsystem. 
ture (see testtimeout() in this table). 
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A buffer exists in the controller's memory to 
hold a copy of data transferred to or from 
the bubble memory. This routine displays 
the contents of that buffer either in ASCII 
characters or hexadecimal. 


Converts an event code into an intelligible 
show event() expmnt.c message which it then displays on the termi- 
nal. 

show. waketime() e balas Displays the date and time when a time-out 
= will end. 
Removes power from anv subsystems which 
shut_down() expmnt.c presently have power. It makes a log entry 
for each such case. 


Removes power from any subsystems which 
presently have power. [t makes no log entry 
of its actions. 


Issues commands to the Solid State Data 
ssdrmode() expmnt.c Recorder (SSDR) to enter various modes of 
operation. 
| Obtains the status code from the Solid State 


termin() inout.c Inputs a single character from the terminal. 


Asks the user for a hexadecimal port address, 
reads that port and displays the data read 
from that port. 











show bubbuff() bubble.c 





























shut_down_no_log() expmnt.c 




















testinput() inout.c 


- 


bubble.c 
testtimeout() 


This routine permits the user to perform in- 
put from and output to anv port in the svs- 
tem. By “port” we mean here an address in 
the input and output space. 








Asks the user for a hexadecimal port address 
and a hexadecimal byte to be sent to the 
port. and sends it there. 










A buffer exists in the controller's memory to 
hold a copy of data transferred to or from 
the bubble memory. This routine permits 
the user to modify the contents of that 
buffer. 


Lets the user test the time-out feature. For 
example, he can request a delay of 15 sec- 
onds. During this delav, the control pro- 
gram Will not respond to input. At the end 
of this period, it will display the current date 
and time. 









testpattern() 
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In one mode of operation, this function 
computes a “wake-up” time based on the 
current time and a specified delay. In an- 
other mode, it checks to see if a “wake-up” 
time computed earlier has arrived or not. 







Converts upper case characters to lower 
case. Non-alphabetic characters are not 


чы 
tolower() соеп changed. This subroutine is from Bilofsky 
(Ref. 18]. 
Converts an unsigned integer to the corre- 
З : sponding hexadecimal ASCII string repre- 
uitoh() convert.c sentation. For example, 45 is converted to 
IDE 


š К isplavs the current version numbe 
version() version.c Display MEn! j ber of the 
control program on the terminal. 


Checks the 10V bus. If the voltage has fallen 
too low, this function returns the value 
TRUE; otherwise it returns the value 

FALSE. 


Checks for any indications of a launch. 
These can come from the Vibration-activated 
Launch Detector or from the Barometric 

Pressure Switches. 































voltages, low() expmnt.c 

















we launched() expmnt.c 
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APPENDIN F. SUBROUTINES, IN ALPHABETICAL ORDER WITHIN 
EACH MODULE 


Table 9. MS/DOS FILE INDEX: This table shows the names of the files in the 
MS DOS files. Subroutines are listed alphabetically by name within each 


file group. 
PURPOSE 


Loads the five parametric registers in the 
bubble memory controller. Most of these 
never change. Two, however, do change of- 
| ten. These two specif the page of bubble 
memory where transfers of data begin. Call 
this function prior to anv operation per- 
fornung input from or output to the bubble 
memory to ensure the parameters are cor- 

| rectly specified. 









SOURCE 
FILE 


















| SUBROUTINE 






bubble.c 














Displavs a menu of low-level bubble memorv 
controller commands. These are useful in 
testing the bubble memorv for proper oper- 
ation. 


bubble.c bubcmdmenu() 












Initualizes the bubble memorv prior to its 
being used. This initialization must always 
be done after power is applied and before 
input and output operations begin. 


| | 1 ] - 
Bubble: bubio() шр from and output to the bub 


Provides a menu of functions permitting the 
user to perform operations with the bubble 
memory. These operations include: 


bubble.c bubinit() | 





— 






l. applying and removing power, 
bubble.c bubmenu() 2. initialization, 
з input, 

4. output and 
5. reading 


the status of the bubble memory. 







bubble.c | bub off() Removes power from the bubble memory. 
bubble.c | bub, on() 












| Applies power to the bubble memory. 
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Issues commands to the bubble memory 
controller and analvzes the status codes 
which result. In many cases, it will attempt 
to issue a command repeatedly if there is 

bubble.c issububemd() some failure, doing this up to a specified 
number of times. This routine is written in 
C and is not fast enough to handle the read 
and write commands. Use bubread() and 
bubwrite() for these. 


bubble ee 


A buffer exists in the controller's memory to 
hold a copy of data transferred to or from 
bubble.c show bubbuff() the bubble memory. This routine displays 
the contents of that buffer either in ASCII 
characters or hexadecimal. 


















A buller exists in the controller's memory to 
hold a copy of data transferred to or from 
the bubble memory. This routine permits 
the user to modify the contents of that 
buffer. 












bubble.c testpattern() 


Takes care of the actual transfer of data from 
the bubble memor» to the controller memory 
during a read. This routine was written in 
assembly language in order to achieve a data 
transfer rate of 16 K bytes per second im- 
posed by the bubble memory hardware. 










Takes care of the actual transfer of data to 
the bubble memory from the controller 
memory during a write. This routine was 
Written in assembly language in order to 
achieve a data transfer rate of [6 K bytes per 


on 
bubrw.s bubwrite() 
second imposed by the bubble memory 
hardware. 
Part of the sequence of steps necessary to 
initialize the bubble memory entails trans- 
ferring the byte Oxff to the bubble memory 
bubrw.s bubxfer() 40 times. This routine does this. The rou- 
tine is written in assembly language for 
speed, but is called in the same manner as a 
C routine. 
Compares two clock times to see which one 
clock.c cloc 
(беке | SEGUE is later than the other. 


Dates and times in the real time clock are 
stored in BCD format. This routine converts 

clock.c clockint() them to integer format to make it convenient 
to perform arithmetic with them. Thus, fu- 
ture dates and times can be computed. 
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ке clockread() Reads the current date and time from the 
real time clock. 
Sets the current date and time in the real 

clock.c clockset() time clock according to values specified by 
the user. 

clock.c clocksum() 
time from the current date and time and 
some desired delav (e.g., 15 minutes). 

dump. clock() Display the date and time on the terminal. 


Display the date and time on the terminal. 
E dump. iclock() This differs from dump, clock() in that the 
= dates and times it uses are integers, not Bi- 
narv Coded Decimal ( BCD) numbers. 


get time() Obtain a valid date and time from the user. 


A menu routine allowing the user to set or 
read the clock, and to test the time-out fea- 
ture (see testtimeout() in this table). 

















Adds two dates and times together to 
produce a new date and time. In practice, 
one uses this to calculate a future date and 













clock.c rtc() 













Displavs the date and time when a time-out 


| show waketime ; 
Е 0 will end. 






Lets the user test the time-out feature. For 
example. he can request a delay of 15 sec- 
onds. During this delay. the control pro- 
gram Will not respond to input. At the end 
of this period, it will displav the current date 
and time. 




















testtimeout() 


al 
ш 


io 


In one mode of operation, this function 
computes a “wake-up” time based on the 
current time and a specified delay. In an- 
other mode. it checks to see if a “wake-up” 
time computed earlier has arrived or not. 







Converts an ASCII string representation of 
a hexadecimal byte into the corresponding 
hexadecimal byte. For example, the string 
“a3” is converted to the byte value Oxa3. 


Converts a four-byte ASCII string repres- 
enting a two-byte hexadecimal word into the 
corresponding hexadecimal word. For ex- 

ample, the string “a34b” is converted to the 
word Oxa34b. 


Converts a string representing a decimal in- 
teger into the corresponding integer. This 
subroutine is from Bilofskv [Ref. 1$]. 
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Converts a BCD byte to the corresponding 
convert.c bcd asc() character string representation. For exam- 
ple, Ox17 is converted to “17”. 
. : Converts a one-byte BCD number to integer 
Converts a single character to its 
convert.c ctoh() hexadecimal ASCII string representation. 
For example, 0xa3 is converted to “a3”. 
) : Converts an integer in the range 0 through 
чо 99 to BCD format. 
Converts an integer to an ASCII string rep- 
convert.c itoa() 


resentation. This subroutine is from Bilofsky 
[Ref. 18]. 

ES 

Rigmaiden of the Naval Postgraduate 


Converts upper case characters to lower 
case. Non-alphabetic characters are not 
changed. This subroutine is from Bilofsky 
[Ref. 1S]. 

delay.s delay() 
School. 

Gets a character of data from the Analog- 
аса) to-digital (à D) Converter. 

Converts a character of raw data from the 

expmnt.c adtoint() Analog-to-digital (A D) Converter into an 


Converts an unsigned integer to the corre- 
integer format with the more meaningful 
expmnt.c 



































sentation. For example, 45 is converted to 
“эру” 

Provides a software-driven time delav in in- 
crements of 10 ms. Written in assembly 
language. but used like a C language routine. 
Adapted from a program by Mr. David 


























sponding hexadecimal ASCII string repre- 
units of volts or degrees kelvin. 







Permits the user to alter the contents of page 
0 of the bubble memory. This is required in 
initializing the experiment. 
















This routine 1s used in the abridged exper- 
iment to prevent record mode from being re- 
started after a power fault. Without this 

safeguard, perfectly good data recorded dur- 
ing launch might be erased. 










bad idea to record() 







Checks to see if the barometric switches have 
been activated vet. If so, launch must have 
occurred and an appropriate log entry is 

made. 








expmnt.c baro switch() 
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Checks to see whether or not there is a ter- 
nunal connected to the RS-232C serial inter- 
face port. 


Returns the value TRUE if the bubble 
memory's temperature is below the temper- 


ature given in the argument to the function, 
FALSE otherwise. 


Displays the contents of any page in the 
bubble memory in a readable format. It will 
not successfully display page 0. Use 

display page0() for this purpose. 


display. page00 I the contents of page 0 in a readable 
do sweep() со" phase of the experiment to 


expmnt.c 














display data page() 


















Causes the Vibro-acoustic Experiment to be 


expmnt.c 
P performed. 


expmnt() 

















Listens for the Auxiliary Power Units 
(APUs) to be activated. It also monitors the 
Vibration-activated Launch Detector and 
the Barometric Pressure Switches to see if a 
launch has occurred without detection of the 
activation of the APUs. 


н | ‘ Makes entries into the event log stored in the 
ерте logevent() bubble memorv. : 


Displays a menu to provide for conveniently 
changing the contents of bubble memory. 
This is essential for properly initiating the 
experiment. 








expmnt.c listen() 










expmnt.c | log menu() 


















Operates the heaters if the temperature of 
the bubble memory is too cold. Ifthe tem- 
perature is too hot, it shuts the heaters off. 
Otherwise it leaves the heaters alone. 


Conducts routine monitoring of events upon 
the completion of the Vibro-acoustic Exper- 
iment. These functions continue until the 

expmnt.c post. launch() Space Shuttle returns to earth, or until the 
10V bus no longer carries sufficient voltage 
for safe operation of the bubble memories. 
In the latter case, the experiment stops all 
operations. 


Performs the record phase of the abridged 
expmnt.c record() experiment. 
; Performs the abridged Vibro-acoustic Ex- 
expmnt.c short_experiment() periment 







expmnt.c monitor_heaters() 
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Converts an event code into an intelligible 
expmnt.c show event() message which it then displays on the termi- 
nal. 


Removes power from any subsystems which 
expmnt.c shut_down() presently have power. It makes a log entry 
for each such case. 


Removes power from any subsystems which 
expmnt.c shut down no log() presently have power. It makes no log entry 
of its actions. 


Issues commands to the Solid State Data 
expmnt.c ssdrmode() Recorder (SSDR) to enter various modes of 
operation. 
A еш 


Checks the 10V bus. If the voltage has fallen 
too low, this function returns the value 
TRUE: otherwise it returns the value 
FALSE: 


Checks for any indications of a launch. 
These can come from the Vibration-activated 
Launch Detector or from the Barometric 
Pressure Switches. 


The UNIWARE compiler provides the 
standard C output routine printf() to provide 
output to the standard output device. IIow- 
cver, this routine requires the user to provide 
a routine fputc() to handle the output of a 
single character to any arbitrary device. We 
only support output by fpute() to the 

ие шш) RS-232C terminal, so this routine is specific 
to that device. The routine will nor output 
a character if, upon checking, it finds there 
is no terminal attached to the serial interface 
port. Thus, when the experiment is operat- 
ing, calls to printf() are of no effect unless 
there is a terminal connected. 


initiale | inithardware() Hours the six ports on NSC810A #1 and 


Processes the special characters CTRL S and 
CTRL Y when read from the keyboard. 
CTRL S is a toggle switch. The first time it 
is pressed, the display halts. The second time 
it is pressed, the display resumes. Subse- 
quently its function alternates between these 
two. CTRL Y invokes the diagnostic sub- 
system. 


expmnt.c voltages low() 


expmnt.c ve launched() 


allow ctrl interrupts() 





104 




































Produces a hexadecimal and ASCII dump 
of anv desired region of memory. 


Sends a single character to the terminal. 


Inputs a string representation of a two-digit 
hexadecimal number from the terminal and 
converts it to hexadecimal format. For ex- 
ample, “3a” is converted to Ox3a. 


inout.c | dump() 












inout.c 







Gets a four-digit hexadecimal number in 
string format from the terminal and converts 
it to a hexadecimal word. For example, 


*3ab2" 1s converted to Ox3ab2. 








inout.c gethexint() 












Inputs a string representation of a decimal 
integer from the terminal and converts it to 
integer format. For example, “352” is con- 
КЕШЕШ @@ УЛ, 


I ` 

j Ask 

Aite | getpageno() Asks the user for a page number in bubble 
| = memory. 


This program can see whether a character 
has been input from the keyboard without 
disturbing the input buffer. 





getint() 

















inout.c look ahead() 














inout.c | portdumpt) 
| 


Outputs a string to the terminal. interface 
port. 





inout.c termin() Inputs a single character from the terminal. 









Asks the user for a hexadecimal port address, 
reads that port and displavs the data read 
from that port. 








| testinput() 
| Asks the user for a hexadecimal port address 
and a hexadecimal byte to be sent to the 

port. and sends it there. 





testoutput() 













First C language subrouune to get control 
| after start-up. Decides whether to invoke 
the menu-driven diagnostic routines or to 
run The Vibro-acoustic Experiment. 








Implements the C language standard library 
function mbrk(). This function was provided 
with the Uniware C Compiler. 













Asks the user for an address in memory and 
the number of bytes he wants to see dis- 

played. It then provides a hexadecimal and 
ASCII display of the contents of the selected 
area of memory on the terminal. 







Displavs the first in a hierarchy of menus 
permitting the user to test subsystems of the 
Vibro-acoustic Experiment individually. 





This routine permits the user to perform in- 
put from and output to any port in the svs- 
tem. By “port” we mean here an address in 
the input and output space. 














- 


newio.s output() 









Inputs a character from a port. Written in 
assembly language, but used like a C lan- 
guage routine. 












Outputs a byte to a port. Written in assem- 
bly language, but used like a C language 
routine. 


Р Inputs the one-byte status code from the 
power.c power_status() ë К ; 
power relay subsvstem. 
swore КОГО) Sends a one-bvte command code to the 
р ў р = power relav subsystem. 


A menu program which let's the user read 
power.c pwrent() the status code from the power relav subsvs- 
| rx "t Displavs the current version number of the 
version.c version() T š 

control program on the terminal. 





tem or send commands to it. 
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APPENDIN G. CONTROL PROGRAM DOCUMENTATION 


We presented a general description of the software as a whole in Chapter 
IV. DESIGN OF THE CONTROL SOFTWARE on page 43. This included a mod- 
erately detailed description of the flowcharts which describe the system, beginning with 
Flowchart 0 in Figure 20 on page 48. This appendix contains more detailed de- 
scriptions of the operation of each subroutine in the control program. A basic know- 
ledge of the C programming language is assumed. 

We have grouped the functions into two broad categories: 


1. major subroutines, and 


2. support subroutines. 


The descriptions in this appendix are best understood by referring to the source code in 
APPENDIX H. CONTROL PROGRAM SOURCE COBE on page 150. 

In Section A. Major Subroutines and Functions on page 10$ we present the major 
subroutines and functions of the control program in an order based roughly on their 
position in the hierarchy of function calls. This section therefore follows the overall 
structure of the control program. 

Referring again to Flowchart 0 in Figure 20 on page 48, we see that the control 
program contains two major parts: 

1. One performs the Vibro-acoustic Experiment. 
2. The other operates a menu-driven svstem to permit testing of the system on the 
ground. 

Once we have discussed the major subroutines, there will remain numerous lesser 
subroutines which we describe in Section B. Supporting Subroutines and Functions on 
page 121. We provide two tables to make it easier quickly to ascertain the purpose of 
subroutines and their locations in several different source files. Table 8 on page 91 lists 
all subroutines by name, and shows in which MS DOS source files subroutines are lo- 
cated. Table 9 on page 99 lists the contents of each MS,DOS source file in alphabetic 
order by name. 

In general, the program attempts to display many diagnostic messages on the ter- 
minal using the printf() function. This function was supplied with the C compiler, but 


it in turn calls a function called fputc() nor supplied with the compiler. The purpose of 
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the subroutine fputc() is to accept a character from the printf() function and to send it 
to the terminal for display. We created this subroutine, and its description is contained 
in Section B. Supporting Subroutines and Functions on page 121. This function al- 
ways checks to see whether there is a terminal attached or not. If not, it makes no at- 
tempt to display any messages on the terminal. Henceforth, whenever we say that 
something will appear on the terminal, it will be understood that this will only occur if 


the terminal is attached. 


A. MAJOR SUBROUTINES AND FUNCTIONS 
1. main() 

This is the beginning point for any C language program. It is called by the 
start-up code, which is written in Z-80 assembly language. The main() program first 
initializes pointers to the buffers which will hold data from the bubble memory. There 
are two formats for such data. One is used in page zero of the memory, which is used 
to record the current status of the experiment. The other format is used in all other 
pages of the bubble memory to record all actions and measurements taken during the 
experiment. The buffers are treated both as arravs and as structures. When thev are 
treated as arravs, it is easv to transfer the data to or from the bubble memory. When 
thev are treated as structures. it is easy to extract individual fields of data. By forcing 
the pointers pagezero and log_page to point to the arrays page0_buffer and log_buffer 
respectivelv, we can access the data subsequentlv bv using either the pointer to the 
structure or the name of the arrav as appropriate. 

The main() program then calls inithardware() to iniuahze the two NSC$810A 
RAM-I O Timer chips on the controller board. Next it checks to see if there is a ter- 
minal attached by calling checkprt(). The absence of a terminal implies that the appa- 
ratus is now installed in the Space Shuttle and the controller should therefore perform 
the experiment. Therefore, if there is no terminal attached, main() will call expmnt(), 
which performs the Vibro-acoustic Experiment. 

If there is indeed a terminal attached, main() calls shut, down, no log(), whose 
function is to remove power from all subsystems without logging that action in the 
bubble memory. The reason for removing power is to ensure that all the subsystems are 
in a known state at the outset. The reason for not wishing to log this action is that the 
log entries should only be made during the course of the experiment. Since the con- 
troller is about to enter the menu subsystem, it is not going to perform the experiment 


and so no log entry is appropriate. 
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Next main() calls menu(), from which all other testable sections of the control 
program can be selected. The option EXPERIMENTOK permits the menu diagnostic 
subsystem to invoke the program expmnt() later. if the user wishes to do so. This would 
permit him to perform the experiment on the ground and so test its operation. 

2. void inithardware(void) 

This subroutine initializes the two NSC810A RAM-LO-Timer chips on the 
controller board. The uses of the pins of port A in each chip are given in Table 4 on 
page 17 and Table 5 on page 17; those of Port B are given in Table 2 on page 15 and 
Table 3 on page 16; and those of port C are given in Table 6 on page 18 and Table 7 
on page 19. 

MDRI 1s the Mode Definition Register of the NSC8I0A #1. Writing a 0x00 to 
it puts port A, into basic | O mode, which is the simplest method of 1 O supported by 
this chip.?? 

DDRII is the Data Direction Register of port A, of the NSCSIOA =1. Writing 
Oxf to it causes each of its bits to be configured for output. 

DDRBI is the Data Direction Register of port B, of the NSCSIOA zl. Writing 
OxfT to it causes each of its bits to be configured for output. 

DDRCI is the Data Direction Register of port C, of the NSCS1IOA «1. Writing 
Ox30 to it causes bits 0 through 3 and bits 6 and 7 to be configured for input. Bits 4 and 
$ are configured for output, although bit 5 is not used in the Vibro-acoustic Experiment. 
Note: this is onlv a 6 bit port; bits 6 and 7 do not evist. 

ТМОТ 15 the register for setting the mode of Timer 0 in NSC$10A zl. Writing 
0x00 to it will stop the timer, an action which must be performed before changing its 
mode. Writing Ox25 will cause the timer to produce a square wave without 
"prescaling" and with "single precision". When prescaling is not used, every pair of in- 
put clock cycles is used to advance the timer's counter bv one. When single precision 
is selected, only the low byte of the timer will ever be read. 

TOLBI and TOHBI are the registers for the low byte and high byte respectively 
of the modulus for Timer 0 in NSC810 #1. This number serves to initiate the timer 
counter. During subsequent operation, the counter 1s decremented once every clock 
period. Each time the counter reaches 0, the timer output switches to the opposite state 
and the timer is reloaded. We write 0x07 to the low byte and 0x00 to the high byte, so 


the modulus is 7. This means that after every seven cycles, the clock is reloaded. The 


22 With basic I O. there is no handshaking (see Glossary) with support hardware. 
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reloading consumes a further cycle, and it takes two complete reloads to go through one 
cycle of the output. The period thus is 2 x (7 - 1) 2 16 clock periods. The NSCS00 is 
driven by a 4.9152 — 22 2.4576 MHz clock. So 16 clock periods take 6.51 us, for a 


clock frequency of = 153.6 kHz. This signal is used as a baud-rate generator 
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on the controller board; it is fed to an Intersil 6402 LART which further divides the 
frequency by 16, yielding a 9600 baud transmission rate at which to drive the RS-232C 
interface. 

STARTO! is the start port of Timer 0 in NSC810 #1. Writing anything to this 
port causes the newly programmed timer to start operating. 

MDR2 is the Mode Definition Register of the NSC810A #2. Writing a 0x00 to 
it puts port A, into basic [O mode. This is the simplest method of I O supported by 
this chip.23 

DDRA?2 is the Data Direction Register of port A; of the NSC810A «2. Writing 
0x00 to it causes each of its bits to be configured for input. 

DDRB2 is the Data Direction Register of port B, of the NSCSIOA #2. Writing 
0x00 to it causes each of its bits to be configured for input. 

DDRC2 is the Data Direction Register of port C; of the NSC810A #2. Writing 
Ox31 to it causes bits 1 through 3 to be configured for input. Bits 0. 4 and 5 are con- 
figured for output. Bits | and 2 are not in use. Note: this is only à 6 bit port; bits 6 
and 7 do not exist. 

TM02 is the register for setting the mode of Timer 0 in NSCS810A #2. Before 
vou can change the mode, vou must first stop the timer. Writing 0x00 to it does this. 
Writing 0x25 will cause the timer to produce a square wave without "prescaling" and 
with "single precision". When prescaling is not used, every pair of input clock cycles is 
used to advance the timer's counter by one. When single precision is selected, onlv the 
low byte of the timer will ever be read. 

TOLB2 and TOHB2 are the registers for the low byte and high byte respectively 
of the modulus of Timer 0 in NSC810 #2. This number serves to initiate the timer 
counter. Once every clock period, the counter is decremented. Each time the counter 
reaches Q, the timer output switches to the opposite state and the timer is reloaded. 
We write 0x01 to the low byte and 0x00 to the high byte, so the modulus is 1. This 
means that after 1 cycle, the clock is reloaded. Now the reloading consumes a further 


cycle, and it takes two complete reloads to go through one cycle of the output. The 


23 With basic I,O, there is no handshaking (see Glossary) with support hardware. 
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period thus is 2x(1+1)=4 clock periods. The NSC800 is driven by a 
4.9152 + 2 = 2.4576 MHz clock. So 4 clock periods take 1.628 us, for a clock frequency 
of ae - = 614.4 KHz. This frequency is used as a clock for the National Semicon- 
ductor ADC0816 Analog-to-digital (A, D) Converter. 

When driven by a clock of frequency 640 kHz, the A Ds normally can complete 
the conversion of an analog signal to a digital value in around 100 us. The frequency 
we are using here, 614.4 KHz, is close to this, so we should get comparable performance. 
[Ref. 19: pp. 8-71 to 8-81] 

STARTO? is the start port for Timer 0 in NSC810 £2. Writing anything to this 
port causes the newly progranimed timer to start operating. 

Finally. we clear bits 4 and 5 of port C, bv writing 0x03 to the port C, 
"bit clear" register. BCLRC2. The purpose of this is to ensure that power to the bubble 
memory remains off, and to ensure that the bubble memory's reset line is held low. 
Strictly speaking. this should not be necessary, since the registers of the NSCSIO are in- 
itialized to be zeros. However, we take nothing for granted, and this precaution helps 
preclude the loss of the bubble memory’s contents that might result from an improper 
application of power. 

3. char checkprt( void) 

This function inspects the TERMON bit (bit 3) of Port C in NSCS10 «2. This 
bit is a 0 if there is an RS-232C terminal connected to the controller. It is a | otherwise. 
The function returns a TRUE in the first case; a FALSE in the second. 

4. void shut down, no log(void) 

This subroutine removes power from any subsystems which are currently on. 
It does not record the fact in the bubble memorv log. which is the only respect in which 
it differs from the subroutine shut_down(). It obtains a character describing the position 
of each of the relays in the power subsystem by calling the function power_status(). The 
series of if statements which then follows causes successive bits of that character to be 
tested. Every time one of these bits indicates that a relay is in the ‘on’ position, that 
relay is turned off with a call to power_write(). 

5. char menu(char experiment_flag) 

This function is at the top of a hierarchy of diagnostic subroutines. The func- 
tion calls the sub-function version() whose only purpose is to display the number and 
date of the current version of the control program. It next presents a menu from which 
the user can select any of a number of categories of diagnostic tests. The function 


termin() is used to obtain a single character from the keyboard, that character is con- 
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verted to lower case by tolower() (if it was not already in lower case), and the character 
is displayed on the terminal. That character is used by the switch to select a case state- 
ment appropriate to the user's choice. The entire process will be executed repetitively. 
The only way to leave it 1s bv choosing to run the experiment. If this is done, the 
function expmnt() gets control. 

To cause a software reset, the program executes an assembler instruction ip 0. 
This function has the effect of restarting the controller at address 0 of memory. This is 
the same address at which execution begins when power is first applied. All variables 
are set to their initial values, other start-up functions are performed as usual, and the 
program main() begins to execute anew. 

The function rte) accesses the real-time clock diagnostic subroutines. 

The function pwrent() access the power subsvstem diagnostic subroutines. 

The function bubmenu() accesses the diagnostic subroutines which can be used 
to test the bubble memory module. The tests available through this selection all are very 
low-level tests. 

When choice E is made, the controller enters a for loop and successively reads 
each of the analog-to-digital (A D) converter channels by calling the sub-function 
adread(). This function returns an eight-bit number addata which is proportional to the 
value read by the A D converter. A call to printf() displays this number along with a 
descriptive adcaption (defined in the file global.c). The first three readings are known to 
be voltages. The remaining values are temperatures, so they are displayed in a slightly 
different format. Furthermore, depending on which channel the A D converter read, the 
number read may represent different magnitudes in the measured units. For example, 
the number 102 may represent 4V or 270°K, depending on which channel was read. 

Voltages, fall either into the range [0, 10]V or the range [0, 20]V. Temperatures 
fall into the range (0, 500]°K. The function adtoint() converts the value read by the A.D 
converter into its value in degrees Kelvin or in hundredths of volts, whichever is appli- 
cable. The converted value is then displayed using the printf() function. To get two 
converted readings per line, carriage returns are placed at the end of every other dis- 
played value, only. 

There are two possibilities if choice F is made. One is that experiment flag is 
TRUE; the other is that it is FALSE. The former case always occurs when menu() is 
called the first time, from main(). However, it is possible to interrupt the execution of 


the experiment and to enter the menu subsystem recursively. It is not possible to make 


menu choice F under these circumstances. To restart the experiment would require first 
making choice A to reset the system. 

The function testio() is called when choice G is made. Its purpose is to allow 
low-level testing of the peripheral devices. 

The function memory_dump() is called when choice H is made. Its purpose is 
to display the contents of the controller’s memory. This is useful only in debugging the 
software. 

The function log_menu() is called when choice I is made. Its purpose is to allow 
the contents of the bubble memory to be displayed. It differs from the functions called 
when choice D is made in that the contents of the bubble memory are regarded by 
log_menu() as formatted data areas, not just as collections of characters. This means 
that the data stored in the bubble memory during execution of the experiment can be 
displayed in an intelligible format, and the experiment's status, stored in page 0, also can 
be displaved in a readable format. The function log_menu() also allows the status to be 
modified in order to affect the manner in which the controller performs the experiment. 
The details of how to do this are contained in Chapter V. HOW TO GET THE EX- 
PERIMENT READY FOR A LAUNCH on page 63. 

6. void version(void) 

This function displays the number and date of the current version of the control 

program on the terminal. 
7. void rtc(void) 

This function displays a menu of functions related to the operation of the real- 
ume clock. The clock can be read, set or tested from here. The method of displaying 
the menu, reading the choice, and taking the appropriate action is identical to that used 
in the function menu() described earlier. The function rtc() differs only in the choices 
and actions possible. 

Choice A causes the function clockread() to be called. It stores the current date 
and time in a structure whose pointer is clock. The function dump clock() is called next; 
it displays the date and time on the terminal. This choice is provided to verify that the 
real time clock is working correctly. 

Choice B causes the function clockset() to be called. It permits the user to set 
the current date and time. The real time clock is powered by its own battery, so this 


option should seldom be required. 


113 


Choice C causes the function testtimeout() to be called. Its purpose is to permit 
the operation of the timeout feature to be tested. It is useful only in debugging the 
software. 

8. void clockread(struct datetime *your_clock) 

This function inputs the binarv-coded-decimal (BCD) time from the real-time 
clock and places the results in a structure pointed to by your_clock. If the current 
number of seconds changes between the start and end of reading. it means that the clock 
has advanced to a subsequent time. To preclude the reading of an incorrect time, the 
input sequence is repeated in the hope that an advance will not occur again. This can 
happen up to 10 x TRIES times. 

For example, suppose the time were 9:59:59 when the seconds and minutes were 
read. The clock might advance to 10:00:00 before the hours were read. Then the time 
read would appear to be 10:59:59, which is wrong by one hour. By reading it again, we 
may avoid this error, but there is no obvious way to guarantee it without stopping the 
clock. Doing so would be disadvantageous, since it would affect timing relationships in 
an unpredictable manner, so we chose not to stop the clock but to take our chances and 
trv reading it again. 

9. void dump_clock(struct datetime *clock) 

This function displavs on the terminal the time stored in a structure pointed to 
by clock. To do this it calls the function bed int(), which converts the BCD values in the 
date and time provided by the real time clock into decimal equivalents. These converted 
values are then displayed by the function printf(). 

10. void clockset(struct datetime *clock) 

This function first calls the function get_time() to ask the user for the current 
date and time. The time specified is left in the structure pointed to by clock. The func- 
tion clockset() then stores the date and time in the real-time clock by repeated calls to 
output(). 

ll. void testtimeout(void) 

This allows the user to test that the time-out function is working. The time-out 
function enables the control program to continue normal processing while waiting for 
some amount of time to elapse. 

For example, after launch the controller will monitor the Solid State Date Re- 
corder (SSDR) for completion of recording. However, it will also initialize a time-out 
of three minutes, and will stop waiting for the SSDR if this time should elapse before the 


SSDR signals completion. The testtimeout() function allows the user to test the time-out 
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feature for any number of seconds. minutes or hours. A menu is presented to the user 
using the same method already outlined in the description of the function menu(). The 
units of the specified delay depends on the menu choice made. The function getint() is 
called to obtain the number of units of delav that the user wants. The current time then 
is obtained with a call to clockread(). and it is displaved on the terminal with a call to 
dump_clock(). The timeout() function then is called to initialize the delay according to 
the number of delay units specified by the user. A while loop calls timeout() repeatedly 
with the NULL parameter. This parameter causes the timeout() function to check to see 
if the desired wake-up time has arrived or not. As long as it has not vet arrived, that 
function returns FALSE and the program continues to loop. If other statements were 
provided before the end of the loop, then they would be performed repeatedly until the 
function timeout() finally returned TRUE, signifving that the desired amount of time had 
elapsed. The function testtimeout() has no such instructions, but when the delay period 
is over, it rings the bell and once again reads and displays the current time. 
12. void pwrent(void) 

This function displays a menu to allow the user to test the operation of the 
power board relays. Any of the attached units. such as the SSDR. can be switched on 
or off from this menu. The method of displaying the menu is the same as that already 
given in the description of the function menu(). Any menu choice from A through J is 
converted to a number in the range [0.9] by subtracting the character ‘a’ from it. This 
number is then used as an index into array relay to select the command to be issued to 
the power control subsystem through a call to the function power write(). Choice К 
causes the power subsystem's status to be read with a call to power status() and then 
displayed on the terminal. The meaning of this byte is shown in Table 2 on page 15. 

13. void bubmenu(void) 

This function displays a menu which lets the user test the bubble memory on the 
controller circuit board. The method of displaying the menu is the same as that already 
given in the description of the function menu(). 

Choice A causes a call to bub_on(). 

Choice B causes a call to bub_off(). 

Choice C attemps to initialize the bubble memory with a call to bubinit(). The 
results of this attempt are then explained with a call to printf(). 


Choice D causes a call to bubemdmenu(). 
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Choice E causes a call to testpattern(). The character string tempbuffer is pro- 
vided to this function for storage of a string of characters entered by the user from the 
keyboard. 

Choice F causes the contents of tempbuffer to be displayed in ASCII format. 

Choice G causes the contents of tempbuffer to be displayed in hexadecimal for- 
mat. This would be useful if the buffer had been loaded from the bubble memory and 
if it contained unprintable characters. Such would be the case if the contents of the 
bubble memory had been generated by performing the experiment, since the experiment 
formats the data in characters which may not all be capable of being displayed. 

Choice H calls getpageno() to ask the user which page of the bubble memory 
he wishes to access. It then calls bubio() to transfer the contents of the buffer into that 
page of the bubble memory. 

Choice I calls getpageno() to ask the user which page of the bubble memory he 
wishes to access. It then calls bubio() to transfer the contents of that page of the bubble 
memory into the buffer. 

Choice J causes a call to rdstatreg(), which reads and displays the contents of 
the bubble memory controller's status register. The format of this register is discussed 
in detail in [Ref. 1]. 

14. char bub on(void) 

This function applies power to the bubble memory on the controller circuit 
board. 

15. void bub off(void) 

This function removes power from the bubble memory on the controller circuit 
board. 

16. char bubinit(void) 

This subroutine initiates the bubble memory on the controller circuit board. 
Power must have been applied first. The sequence of commands is described in 
[Ref. 1: pp. 38-39b]. It is as follows: 

1. Issue the BABORT (abort) command to the bubble memory. 
. Set up the parametric registers, pointing to page 0 of the bubble memory. 


2 
3. Issue the BINIT (bubble initialize) command. 
4 


1. Issue the BFIFORESET (bubble FIFO reset) command to reset the first-in, first- 
out (FIFO) buffer in the controller's bubble memory. 


5. Transfer 40 Oxff characters to the FIFO buffer in the bubble memory. 
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6. Issue the BWRBLREG (bubble write boot loop register) command. At this point, 
the bubble memory is ready for reading and writing. 
17. void bubcmdmenu(void) 
This subroutine allows the user to issue any of the following commands to the 
bubble memory, one at a time: 


1. Abort 


ә 


Load parametric registers 

Initialize 

4. Reset the FIFO buffer 

Perform the transfer of 0 Ox(T characters to the FIFO 


o 


Cn 


6. Write the boot loop register 


These commands are issued by bubinit(), but are provided separately here to permit de- 
tailed testing of the initialization process. 
18. void testpattern(char buffer[ ]) 

This subroutine permits the user to fill a buffer in RAM with characters to be 
written to the bubble memory. Up to PAGELENGTH characters can be written at a 
time. Its purpose is to enable the user to verify that data can be written to the bubble 
memory and read back successfully later. 

This subroutine begins by placing a 0 in the variable c. It asks the user to enter 
a string of characters from the keyboard, and then enters a loop. It will continue reading 
up to PAGELENGTH characters. If it encounters a carriage return, it will place blanks 
in the remainder of the buffer. 

19. void showbubbuff(char buffer[ ], char mode) 

This subroutine will display the contents of buffer either in ASCII format or in 
hexadecimal representation, according to the value of mode. This parameter can be ei- 
ther ASCII or HEX. The ASCII format would be suitable if it were known that the 
bubble memory page buffer contained only printable characters, as it would if it had 
been filled by testpattern(). The hexadecimal format would be suitable if it were known 
that the bubble memory page previously read contained unprintable characters, or if the 


contents were unknown.24 


24 It may be unwise to risk sending potentially unprintable characters to the terminal, since 
some of them have surprising results, such as clearing the screen. 


117 


20. char bubio(char command, int page, char *buffer) 

This subroutine permits reading from or writing to any page of the bubble 
memory. Pages can fall in the range 0 through 8191. Commands can be either one of 
BREAD or BWRITE. The data is placed into or read from the buffer pointed to by 
buffer. 

To operate the bubble memory when the temperature falls below 10°C may 
cause its contents to be destroyed. A call to the function colder_than() precludes this 
from happening. If that function returns TRUE, then it must be too cold. The function 
bubio returns a FALSE to indicate that it was unsuccessful in accessing the bubble 
memory. 

To mininuze power consumption, the subroutine applies power to the bubble 
memory before the operation begins and removes it again at the end of the transfer. [t 
calls bpageset() to set the parametric registers so as to allow the correct page of bubble 
memory to be transferred. It then calls bubread() or bubwrite() as appropriate. After the 
transfer is completed, the subroutine reads the bubble status register to see if the oper- 
ation was successful or not. The bubio() subroutine returns a TRUE if the transfer 
worked; FALSE otherwise. 

21. void rdstatreg( void) 

This subroutine lets the user check the contents of the bubble memory status 
register. The meaning of its contents is shown in Table 10 on page 119. To obtain the 
status code, this subroutine calls the function input(), which reads the contents of the 
port BUBCTRL (port 0x41). This port vields the status code, which is then converted 
to hexadecimal format using the function ctoh() and is displaved. 

22. void expmnt(void) 

This function performs the experiment. Its first task is to call initialize(). This 
subroutine retrieves the current mission status from page 0 of the bubble memory. If 
there is no more room in the bubble memory, a value of FALSE will be returned. Al- 
though the experiment will be performed, no entries can be made in the log. The Solid 
State Data Recorder (SSDR) may therefore still be able to record acoustic data suc- 
cessfully. There will be no log of the events as they occur, however. 

The function expmnt() next checks to see whether the flag full_experiment in 
page 0 is TRUE or FALSE. If not, the function short experiment() is called to perform 
the abridged experiment. Otherwise, the unabridged experiment is to be performed by 


expmnt«(). 
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Table 10. BIT ASSIGNMENTS FOR THE BUBBLE MEMORY CONTROLLER 
— и BYTE: From шс 1 : Chapter 3. p. 12]. 


memi nemi 5 Ready. The FIFO buffer is ready 
to transfer data. 


шашы! — 
= 
— I roren 7 
ا‎ 
L5. [Neümimgem — —  — | 
BEEN m 
I. m 


OP COMPLETE. The current operation 
1s complete. 
been accepted but is not vet complete. 


No OP COMPLETE, 
The BMC stavs busy throughout a data 
transfer. 
The next step is to initiate the sweep phase, if this has not already been done. 






























Busy. This means that a command has 








Recall that this might have occurred if power had been removed from the controller at 
an earlier time, whether by human intervention or through a fault. If the sweep phase 
is required, the function do_sweep() is called to do it. 

Next the controller must decide whether or not a launch has already occurred. 
It consults the launchdone flag in page 0 of the bubble memory. If this flag is TRUE, 
the Space Shuttle launched earlier. Otherwise, we must listen for the activation of the 
Auxiliary Power Units (APUs) by calling the function listen. When this function 
completes its job, it will return a mission status. This can take on any one of the fol- 
lowing values: 


DAPUON The activation of the APUs has been detected. 
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DLAUNCH The activation of the APUs was never detected, but launch was 
detected. This may be the case if the Vibration-activated 
Launch Detector detects the vibration associated with the ig- 
nition of the solid rocket motors or if the Barometric Pressure 
Switches detect an ascent. 


DUSERNOAPU The system is being tested on the ground and the user depressed 
a kev while the system was listening for the APUs. This pro- 
vides a means of terminating the period of waiting for a signal. 

If listen() detects anything, then the function expmnt() will turn on the Analog- 
to-Digital (A'D) Converter by sending the code ADON to the function power_write(). 
It then will turn on the Solid State Data Recorder (SSDR) by sending the code 
SSDRON to the same function. Both these actions will be logged in the bubble memory 
by the function logevent(). If listen() had returned the mission status code DAPLON, 
then expmnt() commands the SSDR to enter scroll mode, which means that it will start 
recording ambient noise. Since the APUs are now on, we know that a launch must oc- 
cur Within seven minutes, or the mission will be scrubbed by NASA. We want to wait 
at least this long. To be on the conservative side, we begin a ten minute time-out period, 
during which we wait for some indication of a launch. The function we_launched() will 
return the mission status code DLAUNCH if it detects such an indication. The function 
look ahead discard() checks to see whether. during ground testing, the user has depressed 
a kev during this time-out period. [f so. we regard the time-out as having been com- 
pleted. This permits accelerated testing of the system without always waiting for the end 
of the full time-out period. Eventually one of the two conditions will have occurred and 
the waiting period will end. 

If the launch had occurred at some earlier time, we would end up in the next 
section of the code in expmnt(). The fact that a launch had occurred previously would 
be logged by calling logevent() with the argument PRIORLAUNCH, and the mission 
status would be set to this same value. 

The next section of code is executed only if a launch is in progress. The SSDR 
is commanded to leave scroll mode and enter launch mode. The SSDR has only enough 
memory to record two minutes of noise after a launch. We initiate a three-minute 
time-out period so that if the SSDR fails to report completion, we will still be able to 
go on to other tasks. During the period of this time-out, we want to ensure that a 
launch is recorded in page 0 of the bubble memory, if in fact a launch has occurred. If 
the launchdone flag in page 0 has not been made TRUE yet, expmtn() calls 


baro switch(). This funcion vill check the condition of the barometric switches. If either 


one has fired. it will make the launchdone flag TRUE. The barometric switches are re- 
garded as the only thoroughly reliable indication of a launch. 

We will terminate the /aunch phase either because the SSDR reports completion 
or because the time-out has occurred. We record whichever of these is the case by call- 
ing logevent() with either the argument DOPCOMP or DNOOPCOMP, respectively. 

Unless expmnt() detected that the launch had been aborted, the experiment will 
next invoke the function post_launch(). This function will keep control until power is 
removed from the experimental apparatus. 


B. SUPPORTING SUBROUTINES AND FUNCTIONS 

The major modules of the control program were described in Section A. Major 
Subroutines and Functions on page 108. Subroutines not described there are described 
here. They are listed alphabetically by the name of the source file in which they are de- 
fined, and alphabetically by function name within file name. 

1. File bubble.c 

d. void bpageset(int page) 
This subroutine initializes the parametric registers in the bubble memory. 

There are five of these. and they contain information about the bubble memorv's status 
and about upcoming data transfers. The meaning of the fields within these registers is 
given in Table 1} on page 122. A complete description of their use is given in [Ref. 1: 


pp. 7-12}. from which the information in Table 11 on page 122 is taken. 


Table 11. CONTENTS OF THE PARAMETRIC REGISTERS IN THE BUBBLE 
MEMORY CONTROLLER: Extracted from [Ref. 1 : Chapter 3, pp. 
С; 


REGIS- 
TER AD- REA Ер CONTENTS 
DRESS 


Least significant eight bits of the 
Least Significant block length. The block length 
Ox0b Byte of the Block is the number of pages trans- 
Length Register ferred to or from the bubble 
memory at one time. 


Most significant three bits of the 
block length. Thus there are 11 
bits in the block length, permit- 
ting up to 2"! = 204S pages to be 
transferred at once. 


The number of Formatter Sense 
Amplifier channels available. 
The binary value 000] 1s appro- 
priate here because we have only 
one bubble memory attached. 
Two channels are used to com- 
municate with the bubble mem- 
ory. With a single bubble 
memory available, the page size 
is defined to be 64 bytes in 
length. 


Most Significant 
Byte of the Block 
Length Register 
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Interrupt enable (normal). We 
set this to 0 because we are not 
using interrupts to communicate 
with the bubble memory control- 
ler. 

















Interrupt enable (error). We set 
this to 0 because we are not using 
interrupts to communicate with 

the bubble memory controller. 


Direct Memory Access (DMA) 
Enable. We set this to 0 because 
We are not using DMA with the 
bubble memory. 


Reserved bv Intel. 


Write Bootlooop Enable. The 
4 
















bootloop is used internally to the 
bubble memory. It need never 
be rewritten except as part of a 
diagnostic test. We let this be 0 
since we don't want to modify the 
bootloop. 


Enable Read Corrected Data 
(RCD). We set this to 1 to per- 
mit the format sense amplifier to 
apply error correction to errone- 
ous data. If the error is uncor- 
rectable, then the erroneous data 
will be transferred to the host 
processor. 







Enable Register 
























Enable Internally Corrected Data 
(ICD). Setting this causes the 
bubble memory to notify the host 
processor of its inability to cor- 
rect erroneous data. In this case, 
it does not transfer that data. 

We set this to O and don't use the 
feature. 














Enable Parity Interrupt. We set 
this bit to 0 because we are not 
using interrupts. 













The least significant byte of the 
address. The address refers to the 
particular page within the bubble 
memory where data transfers are 
to begin. Since we are using a 

block length of one page, this 

actuallv addresses the single page 
we are transferring. 






The Least Signif- 
icant Byte of the 
Address Register 


0-7 
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Most significant five bits of the 
address. Thus there are 
23 = 8192 pages in the bubble 


NS memory. 
Most Significant = 
Byte of the Ad- Magnetic Bubble Memory 


dress Register (MBM) Select. This field con- 
trols which bubble memory is 
addressed. Since we only are us- 
ing one bubble memory, we set 
this to all zeroes. 





b. char issububcmd( char command) 
This subroutine is used to issue a command to the bubble memory con- 
troller on the main controller circuit board. The sequence it follows is given in detail in 
[Ref. 1: pp.40-45]. For our purposes, the sequence is as follows: 


1. Make sure the BUSY bit is 0 before sending anv command (except ABORT). То 
do this, we read the status code in the BUBCTRL port and check the BBUSY bit. 
When this is a 0, we can proceed. More than one attempt will be made to succeed 
in this. If the check fails repeatedly, the subroutine displays the status code and 
returns a value of FALSE. 


2. Issue the conımand to the bubble nıemory controller by calling the function 
output(). 


3. Check to see that the command was accepted. This 1s signalled by the bubble me- 
mory controller's setting the BUSY bit once again. If the BUSY bit is not set 
Within a reasonable amount of time, the command was not accepted. In the case 
of the commands FIFO RESET and WRITE BOOTLOOP REGISTER. we can 
ignore the fact that the BUSY bit never was set if we get an OPERATION COM- 
PLETE anyway. 


4. Wait for the OPERATION COMPLETE code from the bubble memory controller, 
If this does not occur within a reasonable time, the command did not succeed. 

The phrase “a reasonable time" in this subroutine means that the bubble memory 

controller’s status was inspected BTRIES times without success. We have written the 

subroutines such that they will regard the command as having been successful if the 

bubble memory controller returns an OPERATION COMPLETE code even if the 

BUSY bit remains 0. ([Ref. 1] does not suggest that this latter indication can occur. 

However, if the command is accepted and completed very quickly, the control program 
might never observe the BBUSY bit, so it seems to be a good idea to permit it.) 

It was our intention that this subroutine be used to issue all commands to 

the bubble memory. However, it executed too slowly to permit its use with data trans- 


fers. The subroutines bubread() and bubwrite(), written in assembly language, were 
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written for this purpose. In the case of other commands, TRUE is only returned if the 
bubble memory returns OPERATION COMPLETE in the status byte. FALSE is re- 
turned otherwise. 
2. File bubrw.s 
a. char bubxfer( void) 

This subroutine is required during initialization of the bubble memory. It 
writes 40 Oxff characters to the bubble memory. It returns TRUE if the transfer worked; 
FALSE otherwise. The subroutine is written in assembly language for speed, but is 
called in the same manner as a C subroutine. 

b. char bubread( char * buffer ) 

This subroutine reads data from the bubble memory and places it in a buffer 
whose address is passed as a parameter. It is written in assembly language in order to 
execute sufficiently rapidly to preclude overflowing the buffer in the Bubble Memory 
Controller (BMC). The listing of this subroutine includes many comments which explain 
the purpose of each step. The following is a list of the actions which must be accom- 
plished Бу this subroutine. 

l. Save the contents of all registers. 
2. Issue the FIFO reset command to the BMC. 
3. Issue the READ command to the BMC. 


4. Wait for the BUSY bit to become a one. If this never happens, the command has 
failed. 


5. Input 64 characters from the bubble memory. The FIFO bit must be set to l be- 
fore each character is read. If this bit never becomes a 1, the command has failed. 


6. Restore the contents of all registers to what they were before the subroutine began 
to execute. 
c. Char bubwrite(char * buffer) 

This subroutine writes data to the bubble memory from a buffer whose ad- 
dress is passed as a parameter. It is written in assembly language in order to execute 
sufficiently rapidly to preclude having the Bubble Memory Controller (BMC) empty its 
internal buffer before all the data has been sent to it by the experiment controller. The 
listing of this subroutine includes many comments which explain the purpose of each 
step. The following is a list of the actions which must be accomplished by this subrou- 
tine. 

1. Save the contents of all registers. 


2. Issue the FIFO reset command to the BMC. 
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3. Issue the WRITE command to the BMC. 


4. Wait for the BUSY bit to become a one. If this never happens, the command has 
failed. 


5. Output 64 characters to the bubble memory. The FIFO bit must be set to | before 
each character is written. If this bit never becomes a 1, the command has failed. 


6. Restore the contents of all registers to what they were before the subroutine began 
to execute. 
3. File clock.c 
a. void clockint(struct datetime *clock, struct idatetime "iclock) 

This subroutine takes a datetime structure pointed to by clock and converts 
it to an idatetime structure pointed to by iclock. The function bcd, int() is used to convert 
the binary coded decimal (BCD) format used in the datetime structure into the integer 
format used in the idatetime structure. 

b. char clockcompare(struct idatetime *clock1, struct idutetime *clock2) 

This subroutine compares the two times pointed to by clock! and clock2. 
It will return TRUE if the first time is equal to or later than the second; FALSE other- 
wise. To do the comparison, each element of the time is compared, from month down 
to second, in that order. The principle difficulty is in comparing dates that span New 
Year's Day. We want January ] to be regarded as coming after December 31. not be- 
fore. 

To do this we first subtract the second month from the first. The difference 
is taken modulo 12. The modulo operation would not change any difference from 0 
through 11; a difference of —11 through —1 would be changed to 1 through 11 respec- 
uüvelv. Results in the range 1 through 5 indicate that the first date 1s later than the sec- 
ond. 

For example, if the first date is January (month 1) and the second date is 
December (month 12), the difference is 1 — 122 —11. When this is taken modulo 12, 
we get l. Thus January is | month after December. 

If the first date is June (month 6) and the second date is December (month 
12), the difference 15 6 — 122 —6. Taken modulo 12, this 1s 6. Since this 1s greater than 
5, we regard June as coming before December, not after. 

c. void clocksum( struct idatetime "result, struct idatetime *clockl, struct 
idatetime *clock2) 

This subroutine adds together the date and time pointed to by the idatetime 


structure clock! to the number of months, dass, etc, in the idatetime structure pointed 
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to by clock2, vielding a new idatetime structure pointed to by result. This is useful when 
from a given date and time one wishes to calculate a later date and time. The usual use 
of this subroutine is. given the current date and time, to calculate the date and time after 
some given delay has elapsed.25 

It starts by adding the seconds together, and works from there up to the 
months. After each addition, checks are made to ensure that the result is valid. If not 
(e.g., 63 minutes is not valid). the result is corrected and any excess is carried over to the 
next highest unit of time. 

The fact that different months have different lengths is a bit of a nuisance 
which 1s overcome by considering the three possible cases: a month can have 31 days, 
30 days or 28 davs. Leap vears are ignored, since the real-time clock does not store the 
current vear. and so is unaware of leap vears. 

d. void show_waketime(struct idatetime *waketime) 

This function displays the date and time stored in the idatetime structure 
pointed to by waketime on the terminal. 

e. void dump_iclock(struct idatetime *clock) 

This subroutine displays the date and time (when stored in integer format) 
on the termunal. 

f. void get_time(struct idatetime *clock) 

This subroutine asks the user for the date and time. Each response is 
checked for correctness to preclude invalid dates and times being entered. The function 
getint() is used to get the responses from the keyboard. The responses are converted to 
binarv-coded decimal (BCD) format and stored in the structure whose address is passed 
as a parameter to the function. 

g. void show waketime( struct idatetime *waketime) 

This subroutine displays on the terminal the date and time when a time-out 
will have been completed. The date and time are provided in the structure whose address 
is passed as a parameter. 

h. char timeout(int delaytime, int measure) 

This subroutine has two purposes: 


1. It initiates a time-out sequence. 


2. It checks to see whether a time-out sequence has been completed yet. This is the 
case when the wake-up time calculated previously has been reached. 


25 While it could be used to add two dates together, this would not be particularly meaningful. 
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The subroutine calls the function allow_ctrl_interrupts() to permit its being 
interrupted during ground testing by the depression of a key on the terminal. It then 
calls clockread() to get the current date and time. This is converted to integer format 
by a call to clockint(). If the parameter delaytime is the constant NULL, then the 
function’s purpose is to see whether a time-out set previously has expired. The function 
clockcompare() is invoked to compare the stored date and time with the current date and 
time. Its result is returned as the result of timeout(). 

If the parameter delaytime is not the constant NULL, then the function’s 
purpose is to initiate a time-out sequence. The structure waittime is initialized to zero. 
One of its elements is then modified to contain the number of delay units passed as the 
parameter delaytime. Which element is modified is determined by the parameter 
measure, which can take on the values MONTH, DATE, HOURS, MINUTES, or 
SECONDS. The subroutine clocksum() 1s called to add together the current time and 
the amount of time to wait. The result is displayed by calling the function 
show waketime(). The wake-up time is stored in a global structure, waketime, so its 
contents will be undisturbed the next time this function is called. 

4. File convert.c 
a. char atoh( char *ascii) 

This function converts the two-character hexadecimal string pointed to by 
ascii and converts it to a single character.26 If the characters in ascii are in the range ‘0° 
through ‘9’ or ‘a’ through ‘f, then they will be properly interpreted as hexadecimal digits. 
Capital letters (‘A’ through 'F") and any other characters are treated as zeros. For ex- 
ample, the character string “63” would be converted to the single character ‘c’, since the 
hexadecimal representation of this ASCII character is 0x63. 

b. unsigned int atohexint( char ascüf[ ] ) 

This subroutine converts a four-byte ASCII string of characters which rep- 
resent a valid hexadecimal word into a single unsigned integer. No checks are made to 
see that the character string is valid, but invalid characters are sufficient to cause the 
subroutine to stop processing the character string. If no valid string of hexadecimal 
characters is found, the value 0 is returned by this subroutine. 

c. int atoi( char *s) 
This function converts a four-character string to an integer. The string may 


optionally include a sign (+ or —) in the first position. Successive characters will be 


26 No check is made to ensure that ascii is only two characters in length. 
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converted to numeric values if they are in the range ‘0’ through '9'. Conversion ceases 
as soon as a character fails to fall within this range. No checking is done to ensure that 
the number of digits provided can fit within the number of bytes reserved for integers. 
This subroutine is from Bilofsky (Ref. 18]. 

d. char *bcd asc(char bcd) 

This function converts a binary coded decimal (BCD) character into an 
ASCII string. For example, the single byte 0x63 is converted to a two-character string 
"63". The BCD character is first converted to an integer. It is assumed that an integer 
occupies two bytes. If the leading nibble of the character is a 0, it will be converted to 
a space (* "). No check is made to see if the BCD character is valid. The function returns 
a pointer to the ASCII string representation. 

Since it always uses the same storage location to hold the converted result, 
the string should be copied to another variable before bed. ascii() is called again. for the 
old contents will be destroyed. 

e. int bcd int(char bcd) 

This function converts a binary coded decimal (BCD) character into an in- 
teger. No checking is done to ensure the BCD character is valid. The integer result is 
returned. 

f. char *ctoh(char byte) 

This function converts a character byte into a hexadecimal string represen- 
tation. It returns a pointer to the string. Since it always uses the same storage location 
to hold the converted result, the string should be copied to another variable before ctoh() 
is called again, for the old contents will be destroyed. 

g. char int, bcd( int decimal) 

This function converts an integer into BCD format. It will handle positive 
integers in the range 0 through 99. No checking is done to ensure the integer falls within 
this range. The function returns the BCD result as a single character. 

h. char *itoa( int n, char[ ]) 

This function converts an integer n into an ASCII representation. It con- 
verts the integer into digits by taking it modulo 10 and storing the digits in character 
form in reverse order. Upon completion, it reverses the string in place. The result is 
stored in the location pointed to by the parameter s. No check is made to ensure this 
location has enough storage. This is the user's responsibility. However, in a machine 


with two-byte integers, the largest possible integer will contain five digits. The user 


should allow two extra locations for the sign and the terminating NULL character, ог 
seven characters in all. This subroutine is from Bilofsky [Ref. 18]. 
i. char tolower(int c) 

This function converts upper case alphabetic characters into lower case 
ones. This subroutine is from Bilofsky [Ref. 18]. Its use here is a consequence of our 
having used this C compiler during the early work on this project. This function is 
provided in the library supplied with the Uniware C Compiler; with the Toolworks C 
Compiler, its source code had to be included with our source code. It could have been 
removed when we switched over to using the Uniware C Compiler, but it never was. 
There exist other vestiges of our early use of the Toolworks C Compiler that have never 
been eradicated. 

j. char *uitoh( unsigned int word) 

This subroutine converts an unsigned integer to hexadecimal ASCII string 
format. For example, the unsigned integer '28' is converted to the character string 
“ІС” since that is its ASCII representation. 

S. File delay.s 
a. void delay( int n) 

This function provides a timing delay of nx 10 ms .. It is written in Z-80 
assembly language. It will only work correctly if the system clock has frequency f = 2.5 
MHz. It is adapted from a program written by Mr. David Rigmaiden of the Naval 
Postgraduate School. 

6. File expmnt.c 
a. char ad read( char port) 

This subroutine will obtain one character from that channel of the Ana- 
log-to-digital (A D) Converter whose address is pass as the parameter port. It functions 
by writing anything at all to that port address (we chose arbitrarily to send a 0), then 
by waiting for one 10 ms period during which the A/D converter responds, and then fi- 
nally by reading a character from the same port. This is the character returned by the 
subroutine. 

b. int adtoint(char addata, unsigned long multiplier ) 

The purpose of this subroutine is to convert a character input from the 
Analog-to-digital (A, D) Converter into an integer which represents the measured quan- 
üty in more meaningful units than an arbitrary number in the range [0,255], which is all 
that the A, D converter can provide. It would be natural to perform the arithmetic 
scaling of the input eight-bit number addata to the corresponding output value by per- 
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forming ordinary floating-point multiplication and division. This has one drawback in 
a microprocessor application: the executable code to support floating point operations 
takes up rather a large amount of memory. In tests we performed using the floating 
point arithmetic operators provided with the Uniware C Compiler, the subroutines re- 
quired two extra EPROMS of 8 KBytes apiece. We had the room in our controller to 
accept this, but chose not to do so since our need for floating point arithmetic was lim- 
ited to this one function. To program two complete EPROMS every time a new version 
of the program was compiled solely to provide this one use of floating point of arith- 
metic was not warranted, in our judgement. 

The alternative was to perform the scaling operation with fixed point arith- 
metic. The C programming language supports integer operations, but fixed point oper- 
ations With a movable decimal point are not supported. This subroutine uses an implied 
decimal point. As far as the subroutine is concerned, the operands are integers, plain 
and simple. By using unsigned long integers, we have 32 bits of accuracy. permitting 
numbers in the range [0.4.294967296 x 10°]. For our purposes, we have have used a di- 
visor of 10°. This has the effect of reducing the range of useful numbers to [0,4294] . 

The purpose of these manipulations is to permit all the accuracy promised 
by the provision of eight bits from the A D converter while avoiding floating point 
arithmetic. The details of the operation are included as comments in the program listing, 
so will not be repeated here. 

c. void alter pageÜ( struct pageÜdata * pagezero) 

This subroutine permits the user to alter the flags stored in page 0 of the 
bubble memory. Since these flags describe the current status of the experiment, and also 
indicate which area of the bubble memory is available for use, their alteration amounts 
to initializing the status of the experiment to a known value. The use of this subroutine 
is described in Chapter V. HOW TO GET THE EXPERIMENT READY FOR A 
LAUNCH on page 63. 1t displays a menu using the same method used in so many other 
functions in the control program. This method was already presented in the description 
of the function main(). A while loop presents the menu repeatedly until choice Z is 
made. The menu shows the current values of all the information stored in page 0 of the 
bubble memory. In most cases it also shows the other possible value of each flag. The 
sole exceptions are the value of the next available page, which can fall in the range 
[1,8191], and the flag RECORD, start, time, which is a date and time. 


If any of the values is changed, page 0 is rewritten. 
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d. char bad idea to record( char show ) 

In the abridged experiment, the only phase of the experiment is record. It 
would be unfortunate if the Solid State Data Recorder were restarted in record mode 
after the launch had already occurred, for this would erase the recording of the launch 
and replace it with the silence that fills the cargo bay in space, or possibly all the sounds 
of the launch except the moment of ignition of the solid rocket motors. How could this 
happen? A power fault, for whatever reason, would cause the controller to start at the 
beginning upon the restoration of power. There is no obvious way for the controller to 
be sure that it is still on the ground, which certainly is the only time when it is really a 
good idea to initiate the record phase. Of course, it is easy to determine whether it is in 
space or not simply by checking the status of the barometric pressure switches. Our 
solution is simply to prohibit the initiation of record mode more than once in 12 hours. 
If a mission is scrubbed, it will be at least 24 hours before it is rescheduled. The 12 hour 
delay will have elapsed by this time, and the abridged experiment could then be per- 
formed as planned. 

The long and the short of these considerations is that this function com- 
pares the current time to the ume when record was last initiated. This time is stored in 
page 0 of the bubble memory. If insufficient time has elapsed, the function returns the 
value TRUE, meaning that it is a bad idea to record. If 12 hours has elapsed, it returns 
the value FALSE, meaning it is nor a bad idea to record; record mode can be initiated, 
in this case. 

e. void display_pageO(struct pageOdata * pagezero) 

This subroutine displavs the contents of page 0 of the bubble memory on 
the terminal. 

f. void do sweep(void) 

This function performs the sweep phase of the unabridged experiment. [t 
turns on (and logs the fact that it has done so) the Analog-to-digital (A. D) Converter 
and the Solid State Data Recorder (SSDR). It then commands the SSDR to enter sweep 
mode. After a 10 second time-out, it applies power to the Voltage Controlled Oscillator 
(VCO) which is responsible for filling the Space Shuttle cargo bay with sounds of known 
frequency. 

Next it initiates a 13 minute time-out. The SSDR should signal completion 
of the sweep phase before this much time has elapsed. If this does not happen, the 


time-out allows the control program to stop waiting for it to do so. Upon completion 


of the sweep phase, the do sweep() phase removes power from the VCO, SSDR, and A D 
converters. 


g. char initialize( void) 

This subroutine extracts the status information from page 0 of the bubble 
memory when the expmnt() program begins to execute. It will remove power from the 
Voltage Controlled Oscillator (VCO), which performs the sweep phase, and from the 
heater subsystem, if either of these is on. It will not remove power from the other sub- 
systems, Which also might be on when power is first applied. How can this be, and why 
does it not remove power from them? One way in which power might be applied is after 
a brief power fault. If the fault affected the controller but not, say, the Solid State Data 
Recorder (SSDR), and if sweep mode had been initiated prior to the loss of power. re- 
moving power from the SSDR would have the effect of terminating sweep mode and this 
would raise the possibility that an otherwise successful recording of the ignition of the 
solid rocket motors would be foiled. The SSDR and other subsvstems, therefore, should 
not be interfered with at this point. 

h. char listen( void) 

This subroutine applies power to the matched filter circuit board. [t then 
calls we launched(). This function returns DLAUNCH if a launch has occurred, and this 
value is returned bx listen(), too. If a launch has not vet occurred, listen() checks to see 
if the matched filter has detected the starting of the Auxiliary Power Units (APUs). If 
so, the function returns the value DAPUON. If neither condition has occurred, the 
function calls the subroutine look, ahead, discard(). giving the user (if any) to get out of 
the listen() function by depressing any key on the terminal. Barring one of these three 
conditions, the function will continue making these same checks indefinitely. 

i. char logevent( char event) 

This subroutine makes coded entries in the bubble memory of all events 
which take place. While it is doing this, it takes readings from each of the channels of 
the Analog-to-digital (A D) Converter and stores the results in the same page of the 
bubble memory in which the event code is stored. If the bubble memory is already full, 
which would occur after 2 x 8191 = 16,382 events, the subroutine refuses to Store any 
more events. This will preclude the destruction of the records of earlier events. How- 
ever, we do not expect this manv events ever to occur on a single mission of the Space 
Shuttle. The interval between successive events after the first two minutes of flight is five 


minutes; at this rate, it Would take nearly 57 days to fill up the memory. 
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There are two possibilities when the function prepares to write a page of 
information to the bubble memory. Either this is a brand new page, or it is the second 
half on an existing page of stored data. In the former case. the second half of the page 
is filled with NULL characters. This effectively erases any data previously stored in this 
upper half-page. The subroutine next reads the current date and time and stores this in 
the structure where all the information is assembled prior to being transferred to the 
bubble memory. The event code is passed to the function logevent() as parameter event 
to be stored in the bubble memory. Each channel of the A D converter is sampled and 
the results also are stored in the bubble memory. If the event code is CSSWEEP, then 
the command to initiate sweep mode has just been issued, and the flag sweepstarted in 
page 0 needs to be set to TRUE. If the event code is DPRESSURE, then the flag 
launchdone in page 0 needs to be set to TRUE. Then the new record of information can 
be written to the next available half of the next available full page of the bubble memory. 
The page number and half page number are extracted from page 0 of the bubble mem- 
огу. Page 0 needs to be updated. and this is done also. 

j. void log menu( void) 

This subroutine provides the user with a menu for changing the contents 
of page 0 of the bubble memory. Recall that this information describes the current sta- 
tus of the experiment. It is important that this information be initialized correctly prior 
to the launch of the Space Shuttle. How to do this is described in Chapter V. HOW 
TO GET THE EXPERIMENT READY FOR A LAUNCH on page 63. 

The details of how the menu is generated are the same as explained in the 
description of the function menu() and will not be repeated here. 

k. void monitor_heaters(void) 

This subroutine has the job of maintaining the temperature of the bubble 
memory at a sufficiently high level that it can be operated safely. If it finds that the 
current temperature is lower than the minimum desirable temperature (12°C) it will turn 
the heaters on. If it finds that the temperature is above the maximum desirable tem- 
perature (14°C), it will turn the heaters off. This is not the temperature above which the 
bubble memories will lose their memory. Rather it is a temperature chosen to be slightly 
higher than the minimum desirable temperature. If the temperature can attain this level, 
the heaters will be shut off for a while to save power. If the temperature falls to the 
minimum desirable level, this still is 2°C above the minimum operating temperature, al- 
lowing a reasonable margin for safe operation. The 2°C spread is wide enough to pre- 


clude excessively frequent operation of the relay switches, too. 
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l. void post launch( void) 

This subroutine performs the caretaking functions that follow the successful 
launch of the Space Shuttle. Its first action is to remove power from all subsystems. 
It then initiates a five minute time-out. During this wait, it calls monitor. heaters() re- 
peatedly to give them an operation to operate the heater subsystem. It also checks the 
barometric pressure switches if they have not yet reported a completed launch. During 
ground testing it is useful to have a way of interrupting this phase of the mission. 
Calling look ahead discard() lets the user do so by pressing any key on the terminal. 
At the completion of the five minute delay, logevent() is called to record a "read A. D" 
event. The function logevent() takes care of reading all the Analog-to-digital Converter 
(4 D) channels whenver it is called. Finally, a call to voltages low() is made to ensure 
that if the voltages on the 10V power busses falls to too low a level. the experiment will 
be terminated. This will preclude an attempt to operate the bubble memories with in- 
sufficient current, which could cause them to lose their contents. 

m. void record( void ) 

This subroutine performs the record phase of the abridged experiment. The 
first action taken by this subroutine is to read the current date and time and to place this 
information in the structure of data to be stored in page 0 of the bubble memory. A call 
to logevent() immediately after this has the effect of ensuring that this date and time are 
transferred to page 0 right away, along with taking current readings of all the channels 
of the Analog-to-digital (A D) Converter. 

The record() subroutine then applies power to the A D converters and the 
Solid State Data Recorder (SSDR), commands the SSDR to enter recerd mode, and in- 
itiates a 20 minute time-out. The SSDR should report completion of record mode prior 
to the expiration of this delay. but even if it fails to do so, the subroutine will be able to 
terminate the record phase of the experiment. While waiting for the 20 minutes to 
elapse, the subroutine calls baro_switch() if that function has not previously reported a 
successful launch. Upon the completion of the record phase, the subroutine removes 
power from both the SSDR and the A D converter. 

n. void short_experiment(void) 

This subroutine performs the abridged experiment. It first checks to see 
whether a launch had occurred previously. This could be the case if a power fault had 
caused the controller to start executing its program from the beginning. Ifa launch has 


been recorded already, the subroutine refuses to put the Solid State Data Recorder 
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(SSDR) into record mode. This will prevent the successful recording of a launch to be 
wiped out. 

If a launch has not occurred previously, then the subroutine will wait until 
it is alright to initiate record mode. This is indicated by the subroutine 
bad_idea_to_record() returning the value FALSE, meaning it is not a bad idea to start 
record phase. Next the subroutine will call listen() to listen for the starting of the Aux- 
iliary Power Units (APUs). The listen() subroutine will keep control until either the 
APUs start, or until some indication of a launch is detected. At this point, the record 
phase is initiated. 

It is conceivable that at the end of the record phase, we would discover that 
we had jumped the gun and that the Space Shuttle was still on the ground. To see 
whether or not this is the case, the subroutine calls baro_switch(), if that subroutine had 
not previously reported that launch had definitely been completed. If no launch has 
occurred, же аге in a bit of a quandary. Is launch imminent? How long will it be before 
it occurs? It would be nice simply to re-initiate record mode. but this consumes consid- 
erable power. What is potentially worse, the power fault might occur at the moment 
of launch. It will still be several moments before the barometric switches indicate that 
a launch has occurred. Since we cannot ascertain whether the launch has occurred or 
not, it is best to assume that it has and not to re-initiate record phase, which would erase 
the recording of the launch. So we have adopted the solution of waiting until at least 
12 hours more have elapsed before entering the record phase again. 

At the successul completion both of record phase and a launch, the 
short experiment() subroutine calls post, launch() to perform all the caretaking functions 
required during the Space Shuttle's mission. 

0. void show event( char event) 

This function is used to display event codes stored in the bubble memory log 
in a readable form on the display terminal. It does this by displaying the appropriate 
character string from an array of strings which describe the various codes. 

p. void shut down(void) 

This function removes power from any subsystem which currently is re- 

ceiving power. It calls logevent() to record any actions it takes. 
q. char ssdrmode(char mode) 

This subroutine issues commands to the Solid State Data Recorder (SSDR). 
If the command is unsuccessful the first time, it will make several more tries before giv- 
ing up. Once the command has been issued, the subroutine waits for 20 ms and then it 
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checks the status code returned by the function ssdr_status(). The desired response from 
the SSDR is that the commanded operation has been completed successfully, which is 
indicated by the return of the constant NORMOP. The subroutine ssdrmode() returns 
TRUE if this occurs; FALSE otherwise. 

ғ. char ssdr_status(void) 

This subroutine reads the status code from the Solid State Data Recorder 
(SSDR) and returns it to the calling function. 

s. char voltages low( void) 

This function checks the channel of the Analog-to-digital (A, D) Converter 
which allow the measurement of voltage on the 10V bus. The value read is converted 
to voltage by the function adtoint(). If that voltage falls below the minimum voltage 
desirable on the IOV bus, then the function returns the value TRUE, meaning that the 
voltages are too low, and that the experiment should halt. Otherwise it returns the value 
FALSE. 

t. char we_launched(void) 

This subroutine first calls the function baro_switch() to see whether the ba- 
rometric pressure switches have detected an ascent of the Space Shuttle. If this has oc- 
curred, or if the Vibration-activated Launch Detector has detected a launch, this 
function returns the value DLAUNCH. Otherwise it returns the value FALSE. 

7. File fputc.c 
a. int fputc( int chr, void * device) 

The UNIWARE compiler provides the standard C output subroutine 
printf() to provide output to the standard output device. However, this subroutine re- 
quires the user to provide a subroutine fputc() to handle the output of a single character 
to any arbitrary device. We only support output by fputc() to the RS-232C terminal, so 
this subroutine is specific to that device. 

This function calls the subroutine allow ctrl interrupts() to permit the user 
to interrupt operation of the control program. The subroutine will not output a char- 
acter if, upon checking, it finds there is no terminal attached to the serial interface port. 
Thus, when the experiment is operating, calls to printf() are of no effect unless there is 
a terminal connected. 

The subroutine returns —1! if there is no terminal connected. This is the 
code specified by UNIWARE if fputc() is unable to do the output operation. If there 


is a terminal attached, fputc() repeatedly polls the serial interface, waiting for it to be 
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ready to accept output data. [t then outputs the character, and returns that character, 
again as specified by UNIWARE. [Ref. 17: Compiler Section, pp. 45 and 52] 
8. File global.c 
This file contains the declarations of variables used throughout the control 
program. The author's predilection is to avoid the use of global variables. However, it 
can sometimes become so awkward to observe this preference as to make it sillv. [t is 
desirable to hold the use of global variables to a minimum, however. 
9. File inout.c 
a. void allow ctrl interrupts( void) 

This subroutine makes it possible for the user to interrupt the execution of 
the control program. Whenever it gets control, it calls the function look, ahead() to see 
if any key of the terminal has been depressed by the user. If not, then the function re- 
turns without further ado. Ifa key has been depressed. however, it may have been one 
of the two control keys CTRL Y or CTRL S. If so. the function termin() is called to 
remove the character from the input buffer, and to respond appropriately to the input 
control character. 

b. void dump( unsigned int address, unsigned int length) 

This subroutine displavs the contents of a section of memory on the display 
terminal. The variable address designates the address of the first character of data to 
be displayed. The variable length specifies how many characters to display. The display 
shows a hexadecimal representation of every character in the chosen section of memory, 
and if that character has a printable form, that form also is displayed. This function is 
of value only for debugging the control program. 

c. char gethex(void) 

This subroutine obtains a hexadecimal string from the terminal. Up to 
HSTRLEN characters will be accepted. Processing will cease as soon as a character not 
in the ranges ‘0’ through ‘9’, ‘a’ through ‘f, or ‘A’ through ‘F’ is entered. The input 
string will be converted to a single character by calling atoh(), and this character will be 
returned. For example, the string “6a” would be converted to the ASCII character ‘j’, 
whose hexadecimal representation is Ox6a. This subroutine is useful for getting one-byte 
system port addresses from the user if he is more likely to know them in hexadecimal 
than in decimal. 

d. unsigned int gethexint(void) 
This subroutine is very similar to gethex(), except that it accepts two hexa- 


decimal bytes, not just one. 
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e. int getint( void) 

This subroutine obtains a decimal string from the keyboard. L poto 
STRLEN — I digits can be entered. Processing will cease as soon as a character not in 
the range ‘0° through ‘9’ is entered. The input string will be converted to an integer by 
calling atoi(). and this value will be returned. 

f. int getpageno(void) 

This subroutine obtains a page number in bubble memory from the user. 
Valid responses are in the range 0 through MAXPAGE. It uses the subroutine getint() 
to obtain the response. 

g. char look ahead( char *character) 

This function checks to see if a key has been pressed on the display terminal. 
Of course, if there is no terminal attached, there is no point in even looking, so the 
function returns instantlv in this case with a value of FALSE. The variable 
console data available is one of two variables known to all functions in the file inout.c. 
It will have the value TRUE 1f the function look ahead() or the function termin() dis- 
covered previously that there was a character available to be read. The look  ahead() 
returns this character to the calling function for it to inspect, but it does not remove the 
character from the buffer. Further calls to look ahead() or to termin() would obtain the 
same character. 

If there is no character already in the buffer (that is, if 
console data available is FALSE,) then look_ahead() checks the RS232C interface to see 
if a kev has been pressed. If so, the character is read and placed in the variable 
console buffer for future use by look_ahead() and termin(). It also is returned to the 
calling function. and the value of console_data_available is set to TRUE since a character 
now is in the console buffer. 

А. char termin( void) 

The primary purpose of this subroutine is to read a character from the ter- 
minal whenever the latter has one available. This condition is known to be true when- 
ever bit PRTRDY of port PRICTRL isa 1. The input character is returned to the 
calling function. 

In order to permit the control program to be interrupted, however, the 
function termin() interprets the characters CTRL S and CTRL Y specially. CTRL S is 
interpreted to mean "stop displaying data on the display terminal" if data is being dis- 
played, or "start displaying data on the display terminal" if the display has already been 
halted by CTRL S. In other words, the CTRL S switch operates as a toggle switch to 
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stop and start the display of data. CTRL Y is interpreted to mean “call the diagnostic 
subsystem menu”. We do not wish this to be done more than once at a time. for oth- 
erwise we might make so many recursive calls to the program menu() that the stack 
would be corrupted. 

The variable allow_menu_call will be TRUE the first time termin() is called. 
If CTRL Y is entered, allow. menu, call is set to FALSE, and further calls to menu() are 
precluded thereafter. It is only returned to the value TRUE if the menu() program is 
completed bv the user later. 

The variable waiting for ctls will switch from FALSE to TRUE or back 
again each time CTRL S is entered by the user. Data from the keyboard will only be 
accepted when this variable is FALSE, in which case the display has not been halted. 

The variable ctr] valid data will be а copy of the variable 
console data available described earlier. 

If no data has been read into the console buffer previously by termin() or 
bv look ahead(). then termin() will wait until a character is available. Once this occurs, 
the variable console data available 1s set to FALSE, since termin() has filled and emptied 
the console buffer all at once. A switch statement allows the character to be interpreted. 

i. void testinput( void) 

This subroutine asks the user to specify a port address in hexadecimal. It 

then reads a character from that port and displays it on the terminal. 
Jj. void testoutput( void) 

This subroutine asks the user to specify a port address in hexadecimal, and 
then asks for a hexadecimal byte to be sent to that port. The data is accordingly output 
to the port. 

10. File main.c 
a. void memory_dump(void) 

This subroutine asks the user for the first address in memory whose con- 
tents he wishes to inspect, and for the number of characters which he wishes to see dis- 
played. It then calis the subroutine dump() to honor the request. This function is only 
useful for very low-level debugging of the software. 

b. void testio( void) 

This subroutine presents a menu permitting the user to send data to anv 

port, and to read data from any port, in the system. The method of implementing a 


menu is the same as that presented in the description of the function menu() and will not 
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be repeated here. For output to a port, the function testinput() is called. For input from 
a port, the function testoutput() is called. 
11. File mbrk.s 
a. char *mbrk(long size, long *realsize) 

This subroutine is written in Z-80 Assembly language. It is described in 

{Ref. 17: Compiler section, p. 51]. from which it is drawn. 
12. File newio.s 
a. char input(char port) 

This subroutine is written in Z-80 Assembly language. It inputs a character 

from a port and returns it to the calling function. 
b. void output( char port, char data) 

This subroutine is written in Z-80 Assembly language. It outputs a char- 

acter to a port. 
13. File power.c 
a4. void power status( void) 

This subroutine returns the status byte from the POWERIN port. This 
status is described in Table 3 on page 16. 

b. char power write( char command) 

This subroutine issues commands to the power circuit board. Valid com- 
mands are SSDROFF and SSDRON (to turn the Solid State Data Recorder off and on); 
VCOOFF and VCOON (to turn the Voltage Controlled Oscillator off and on): ADOFF 
and ADON (to turn the Analog to Digital Converter board off and on); MATFOFF and 
MATFON (to turn power to the matched filter, launch detector and barometric switch 
off and on); and HEATOFF and HEATON (to turn power to the heater circuit off and 
on). 

A command can be executed by writing it to the POWEROUT port and 
then setting bit PWRSTROBE in port C, to a l. A delay of length PWRDELAY is re- 
quired before bringing that bit to 0 again. Another delay of the same length is then re- 
quired. These delavs ensure proper functioning of the relays. Each bit in the status byte 
returned by the function power  status() indicates whether the associated relay is on or 
off. The bit is 0 if the relay is on; 1 otherwise. The power write() function examines the 
bit corresponding to the relay it attempted to switch. A TRUE is returned if the relay 


is in the desired position; FALSE is returned otherwise. 
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14. File start.s 

This file contains the controller's start-up code. It is written in Z-80 Assembly 
language. Whenever the Z-80 receives power, it starts executing from location 030000. 
The start-up code initiates the stack pointer to the value STACKTOP and then causes 
a jump to START. All other Z-80 interrupt locations are initialized such that they cause 
a jump to the same location, since interrupts are not used by the controller. At START, 
the ix register is initialized to 0. This register is used by the C compiler to point to pa- 
rameters and local variables within C programs. 

Memory may be requested bv C programs using the mbrk() function provided 
with the UNIWARE C Compiler. The start-up code uses a variable MBRKPTR to 
point to the next available address of allocable memory. Initially this variable is set to 
MRAM, a global variable set in the file \vibro\control\object\spec to point to the begin- 
ning of all allocable memory. Once mbrk() has obtained some memory, it keeps it, so 
the start-up code never needs to reclaim it. Consequently, MBRKPTR can only in- 
crease; it can never decrease. 

ZRAMSZ is the number of RAM locations starting at ZRAM which are used 
for uninitialized, static variables in the C programming language subroutines. The 
Start-up code writes Zeros to all these locations, because the C programming language 
specification is that uninitialized static and external variables be initialized to 0 by the 
compiler [Ref. 16: p. 198]. 

IRAMSZ is the number of RAM locations starting at IRAM which will contain 
initialized data. This data is stored in ROM locations starting at RAMDATA at the 
tme the program is burned into ROM. The start-up code copies it from ROM to RAM. 
Finally, control is passed to main(), the user's C program. If main() should ever return 
control to the start-up code, a halt instruction is executed. The start-up code is adapted 


from an example given in [Ref. 17: Compiler Section, pp. 13-15.] 
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Table 12. CONTENTS OF SUBDIRECTORY \VIBRO\CONTRLR\BATCH 


This batch file simplifies the assembly of Z-80 assembly lan- 
guage source code. To use it, tvpe asm « source filename ? .s. 
For example, to assemble the file delay.s, type asm delay.s. 
Note that the file type need not be s, but whatever it is, it must 
be present. Use of s is recommended for clarity. The proce- 
dure produces object files in subdirectory \vibro\contrIr\object 
and assembly code list files in subdirectory \vibro\contrIr\list. 
See the description of the batch file asmlist.bat for instructions 
on how to produce this listing file, which includes all addresses 
supplied bv the linker. 



















ASM.BAT 













This batch file produces a listing of the assembly language 
source file generated by the Z-80 assembler. To use it, tvpe 
asmlist « filename.filetype » . The output 15 appended to the 
file \temp\print. It can be printed by use of the batch file 
promout.bat. These listings include all global addresses sup- 
plied by the linker. provided \vibro\contrIr\vibro.out has been 
generated bv promlink.bat. 





ASMLIST.BAT 














This batch file simplifies the compilation of C source code. To 
use It. type €. € source file name» .c. For example, to compile 
the file vibro.c. type c vibro.c. Note that the file tvpe need not 
be с. but whatever it is, it must be present. Use of ç is recom- 
mended for clarity. The procedure produces object files in 
subdirectory \vibro\contrlr\object and assembly code list files in 
~ subdirectory \vibro\contrIr\list. 


See the description of the batch file asmlist.bat for instructions 
on how to print listing files, which show all addresses supplied 
by the linker. 


This batch file produces a listing of any MS DOS file. To use 
it. type list <filename.filetype >. The output is appended to 

the file \temp\print. It can be printed by use of the batch file 
promout.bat. 

















LIST.BAT 
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LOADMAP.BAT 


PRINTALL.BAT 


PROMLINK.BAT 


PROMOUT.BAT 


This batch file appends a copy of the load map into 
\temp\print. It can be printed by use of the batch file prom- 
out.bat. 


The load map shows the absolute addresses at which the eight 
regions of code produced by the compilation, assembly, and 
linking steps are placed. It is useful to have this so that you 
know whether the controller has enough RAM and ROM in- 
stalled to hold the output program. The listing shows the 
starting address of each region and the number of bytes it oc- 
cupies. Regions reset, code, const, string. and data all must be 
stored in ROM initially. Of these, only data belongs in RAM 
eventually, yet it must be stored in ROM initially. 


The reason is that it contains C variables whose values have 
been initialized. If they were not stored in ROM. those values 
would not be available at execution time. The start up routines 
in \vibro\contrir\asmsource\start.s cause these initialized vari- 
ables to be copied from ROM to their proper locations in 
RAM. These locations are those shown in the load map. 


Thus, in addition to the ROM space required for the other four 
regions, be sure to allow enough room for the data region to 
be loaded into ROM, too. For example. if there is onlv one 
SK ROM installed at location 0x0000, but the load map shows 
that more than SK of ROM is required, then there is insuffi- 
cient ROM in place. Either more must be added. or the pro- 
gram must be reduced in size. How to load the executable 
program into ROM is described below in 2. Getting the Exe- 
cutable Program into EPROM on page 146. 


This batch file will produce a listing of all source files. all batch 
files, a load map, and a symbol listing. The output will be ap- 
pended to the file \temp\print. Normally vou would first empty 
this file using readyout.bat. After producing a complete listing, 
it could be printed on the printer using promout.bat. 


This batch file simplifies the conversion of the object modules 
into an executable output program. To use it, just type prom- 
link. 


It creates two output files. The first of these is 
\vibro\contrir\vibro.out. It contains information about the ad- 
dresses assigned by the linker to global variables. This file is 
used by the batch file promsym.bat. 


The other file which promlink.bat produces is vibro.hex which 
can be loaded into an EPROM. 


This batch file causes the file \temp\print to be printed. The 
latter file contains the output of the list, asmlist, loadmap, or 
promsym batch file executions. It does not erase \temp\print. 
Use readyout.bat to do this. 
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This batch file appends a listing of all the variables known 
globally throughout the control program to the file 
Memplprint. These include both C language source code vari- 
lev ables, Z-80 assembly language global svmbols, and several 

я symbols defined bv the linker specification file. This listing is 
useful in determining how variables have been declared and in 
finding the absolute addresses of symbols. It can be printed 
by use of the batch file promout.bat. 


This batch file should be used before using any of the follow- 
ing: 
l. list.bat 
. asmlist.bat 
. printall.bat 
. promsym.bat 


. loadmap.bat 


Its purpose is to empty the temporary files \temp\temp and 
\temp\print prior to their being used bv those other batch files. 
Once used, vou need not use it again unless vou have already 
printed the contents of the temporary file and need it no lon- 
ger, or unless vou wish to discard it for some other reason. 





C. PROGRAM MAINTENANCE 
This section describes how to compile a new version of the controller program: and 
how to get an executable version of that program into an EPROM. A basic familiarity 
with Microsoft MS DOS is assumed. The file organization is described in APPENDIX 
D. HIERARCHICAL ORGANIZATION OF SOFTWARE FILES on page 88. 
1. Procedures for Generating a New Executable Program 
a. Compile the C source files 
For each source code file written in the C language, type c < filename >.c. 
b. Assemble the Assembly Code Source Files 
For each source code file written in Z-80 assembly language, type 
asm < filename >.s. 
c. Link Modules Together 
Enter the command promlink. This links all executable modules together, 
generating an executable program module in file vibro.bin in subdirectory \vibro\contrlr, 


which becomes the current directory upon completion. 
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Table 13. CONTENTS OF SUBDIRECTORY \VIBRO\CONTRLR\CSOURCE 


Con ee which operate the real time clock on the 
опаш PE EEDE which perform conversion of data from one 


Contains programs which are specially designed for use with 
the Vibro-acoustic Experiment. Thev are not usable by other 
applications, although they might be tailored to them. 


EPETC.C Contains the routine fputc(). 


Contains the declarations of the few variables which are de- 
GLOBAL.C clared with global scope (£.e., which are known to all subrou- 
tines). 
INITIAL.C 
INOUT.C 


MAIN.C 
























EXPMNT.C 

















Contains programs which initialize both NSCSIOA 
RAM-I O-Timer chips on the controller board. 













Contains programs which handle input from and output to any 
device. 










Contains the highest level of programs which operate the con- 
troller, including the C subroutine main(). These include most 
of the menu-driven routines which are executed if there is a 

terminal attached to the controller when it receives power. 


Contains programs which operate the electrical power relay 
POWER.C board in the controller. This board supplies power to various 
hardware subsystems. 


2. Getting the Executable Program into EPROM 


a. Copy the Executable Program to a Diskette 






Place a 5 1/4 inch diskette in drive B. Then enter the command copy 
vibro.hex b:. This puts a copy of the file vibro.hex on the diskette. This file contains a 
hexadecimal format of the code which, when loaded into an EPROM, will allow the 
controller to function. 

b. Prepare to Write EPROMs 

We have acquired the Intel program PCPP PC Personal Programmer to 
load data into EPROMs. Take the diskette to the IBM Personal Computer (PC) with 
the EPROM programmer. This PC is located in Space Lab #2, Room 102, Bullard Hall, 
Naval Postgraduate School. Be sure you have enough EPROMS available. 
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Table 14. CONTENTS OF SUBDIRECTORY 
\VIBRO\CONTRLR\ASMSOURC 


This file contains the routines bubread(), bubwrite() and bubx- 
fer(). These routines had to be written in assembly language 
because the compiled code would not execute fast enough cor- 
rectly to perform data transfers with the bubble memory con- 
troller. Each routine looks just like a C language subroutine 
to the calling routine. 











BUBRW.S 


This file contains a delay routine written in Z-80 assembly 
7 code. but it can be called as if it were a C language subroutine. 
DELAY.S : E us = A: 
Its purpose is to provide delays in multiples of 10 ms in situ- 
ations where the hardware requires it. 


This is a routine supplied with the UNIWARE C compiler. Its 
purpose is to allow C programs to request memory through the 
standard allocation routines malloc() and calloc() 

[Ref. 17: Compiler section, pp. 50-51]. 














MBRK.S 










This file contains the two routines input() and output(). Thev 
are written in Z-SU assemblv code, but thev can be called as if 
they were C language subroutines. They provide the ability to 
read characters from and write characters to any valid port 

address. 






NEWIO.S 













This file contains the Z-80 initialization code, such as an ad- 
dress where execution should begin, interrupt vectors, code for 
initializing RAM, and a call to the main() program. located in 
the C source file vibro.c. It is adapted from code provided by 

UNIWARE. 






START.S 


To ensure they are empty, place them in the EPROM eraser and turn on the 


fluorescent light to erase their contents. While this 1s going on, and once the PC is 
booted up, enter the command cd pcpp at the command line. This will make pcpp the 
current subdirectory, and so the program pcepplod can be issued to initialize the program 
which will write the file vibro.hex into the EPROMs. Once this has been done, enter the 
command ipps channel(3), which actually invokes PCPP. 
PCPP now has control. Enter the following commands: 
t 2764 This command allows 2764 EPROMs to be used. 


i S0 This specifies that INTEL $8080 hex format files are being used. 
This is the format of the program in the file vibro.hex. 
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Table 15. CONTENTS OF SUBDIRECTORY \VIBRO\CONTRLR\HEADERS 


















File 
BUBBLE.H 


Contents 


This file contains the extern declarations of the routines in 
bubble.c. 


This file contains the extern declarations of the routines in 


BUBRW.H bubrw.s. 


This file contains the extern declarations of the routines in 


CLOCK.H clock.c. 


This file contains the extern declarations of the routines in 


CONVERT.H convert.c. 


DELAY.H n file contains the extern declarations of the routines in de- 


This file contains the extern declarations of the routines in 


EXE. Ewe expmnt.c. 


This file contains the extern declarations of the variables in 


GLOBAL.H global.c. 


This file contains the extern declarations of the routine in ini- 


ИИИ tale 


This file contains the extern declarations of the routines in in- 
out.c. 






КОДЕИН 


MAIN. H a a contains the extern declarations of the routines in 


This file contains the extern declarations of the routines in 


NEWIO.H x 
newio.s. 


POWER.H T contains the extern declarations of the routines in 


This file contains definitions of all constants used by the C 
routines. It also contains definitions of global structures used 
throughout. 









VIBRO.H 


b This performs a check to ensure the EPROM currently loaded in 
the socket is blank. It should be obvious that a blank EPROM 
must be inserted in the slot before performing this check. 


c:vibro.hex (0000, 1 fff) t p 
c:vibro.hex (2000,3fff) t p 
c:vibro.hex (4000,5fff) t p 
c:vibro.hex (6000,6c23) t p 
c:vibro.hex (e000,e127) t p (0c24) 
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The last five commands copy the program instructions from the diskette into the EP- 
ROM. The numbers in parentheses are the addresses which are to be loaded into each 
EPROM. A new EPROM should be inserted into the socket prior to executing each of 
the first four commands. The number 0x6c23 in the fourth command is one less than 
the number RAMDATA in the symbol table. The number 0e127 is one less than the 
value of ZRAM in the symbol table. The number 0x0c24 is 0x6000 less than the number 
RAMDATA in the symbol table. This number tells the PCPP program where in the fi- 
nal EPROM to begin writing this section of data. Since the EPROM addresses all are 
in the range [0x0000,0x 1fIT], subtracting 0x6000 from the actual starting address is nec- 
essary to get the address into the proper range. Note that the last command causes the 
data which eventually will be placed in RAM to be loaded at the end of all the data 
which is to remain in EPROM locations. It is conceivable that this information would 
not fit onto the end of a single EPROM but might spill across the end and require an- 
other EPROM. This would require modifying the instruction sequence shown above. 
For details, consult [Ref. 20]. The command exit will terminate the operation of the 
PCPP program. 

This completes the loading of the control program into EPROM. The EP- 


ROMs can now be loaded into the controller for testing. 
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APPENDIX H. CONTROL PROGRAM SOURCE CODE 


A. FILENAME SPEC 


EK EEE E EE EE EE EE E EE 3 EE 3E EE E E E EE IE IE E EE EEE E EE IE JEJE JEJE JEME JEJE IE JEJEJEJE JE JEJE IE E EE EEE FE IE IE JEJEJE JEJEJE 


Specification file for the Controller hardware. Also see 
companion files "start.asm" and "mbrk.asm". This specification 
assumes 32K of ROM at address 0x0000, and 8K of RAM at address 0xe000. 


3€ €9E3€E EEEE3E EE E3EEEXEO E E E E E E E E EEE E EE E E EE E JE JE JE JE JE JE JE JE JE JEJE JEJEJE JEPE JE IE JEJE IE JEJEJE JE JE JE JE JE E EE € (GC 


partition ¢ 


overlay ¢ 

region () reset [addr = 0]; /* reset vector */ 

region () code, const, string; /ж other ROM */ 

RAMDATA = $3 /ж ROM to initialize region ram */ 

SAA HEIE IE PE ЗЕ ЭЕ ЭЕ ЭЕ FE IE DEDE IE Ê JEFE FE JE JE E E E E E ЭЕ X JE E E E E JE PEE FE E EE PE JE E JE € € € 
Region ram is initialized at runtime startup by 
copying data from RAMDATA to IRAM. The data must 
actually be linked to its RAM address (IRAM) to get 
correct variable addresses, but must be 
programmed into ROM here. By hand, you must 
ensure that ENDDATA <= ENDROM. (ENDDATA is below) 

ЖЕ ЭЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ JE JE JE JE FE FE E 3E E FE JE JE JE JE JE JE JE JE FE ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ // 


ENDROM = 0х8000; Z% end of ROM */ 


IRAM = 0xe000; /* RAM starts here. */ 


region () data Laddr :0xe000 1; /* RAM to be initialized on reset */ 


IRAMSZ = $ - IRAM; /* * bytes to copy from RAMDATA x/ 


ENDDATA = RAMDATA + ($ - IRAM); “7% compare this against ENDROM x/ 


ZRAM = $; 7* Pointer to start of ram region. */ 
region () ram; /* RAM to be zeroed on reset x/ 
ZRAMSZ = $ - 2ВАМ; /* # bytes to zero on reset */ 

MRAM = $; 


region () mbrkram[sizez0x250]; /* RAM available to malloc() */ 
MRAMSZ = $ - MRAM; 


region () stack [size=0x500); /* stack of at least 0x500 bytesx/ 
STACKTOP =0x10000; 7% stack pointer reset value */ 
) оу 


) p [size=0x10000]; 


B. FILENAME VERSION.H 


extern void version(void); 
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C. FILENAME VERSION.C 


void version! void); 


ааа а наан а ааа ва ЗЕ E E E EE E E E о Ае Аа-а е е зе аа He e de eo ече зе Е Û E E 
void version( void) 
t 

printft 
"nmnrControl program for the Space Shuttle Vibro-acoustic Experiment. nr. 
Version 6.19 April 14, 1989nr"); 
3 


D. FILENAME VIBRO.H 
/* vibro.h */ 


Sdefine TRUE Oxf f 

Sdefine FALSE 0x00 

Sdefine EXPERIMENTOK 0Х11 /* As a parameter to menu( ),; this true flag 
permits the experiment to be run. */ 


Rdefine SELECT 0х1 7* Select appropriate power relay. */ 
define ASCII 0 /* Used as a parameter to showbubbuff(). x/ 
Rdefine HEX 1 /* Used as a parameter to showbubbuff( ), */ 


*define NULL 0x00 /* The following are ASCII definitions. */ 
Sdefine BELL 0x07 


Sdefine BS 0x08 
define CTRLS 0x13 /* Permits output to be halted and restarted. */ 
define CTRLY 0x19 /* Permits the menul) program to be entered 


recursively anytime console I/O takes place. 

Only one recursive call at a time is supported. */ 
#define SPACE 0x20 
Rdefine DELETE 0х7# 


Rdefine STANDBY 0x01 /* These are masks for the SSDR commands and. */ 
Rdefine SWEEP 0x02 /* status codes. */ 

#define SCROLL 0x04 

#define LAUNCH 0x08 

#de fine RECORD 0х10 

Rdefine PLAYBACK 0x20 

#define OPCOMP 0x40 

fdefine NORMOP 0x80 


fdefine TRIES i /* Number of times to try something before giving up. #/ 


fdefine BLOCKS PER PAGE 2 
/* The number of data blocks per page 
of bubble memory. */ 
fdefine RECORD DELAY 12  /* The number of hours to wait after initiating 
RECORD mode before daring to restart it. */ 


/* The following constants are used by the routine adtoint() to convert 


values read by the A/D converter into the corresponding real-world units. */ 
fdefine MULT, TEMP 19607841 /* UK per unit on the A/D converter. */ 
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Sdefine MULT 10V 4862745L /* 10E-2V per unit on the A/D converter. */ 
fdefine MULT 20V 9725490L /* l0E-2V per unit on the A/D converter. */ 


#Hdefine MIN_VOLTAGE_10 850 /* 8.50 V is the minimum permissible 
voltage on the 10V bus. The constant 
represents this in units of lE-2 V. x/ 

fdefine MIN OPERATING TEMP 283 /* The bubble memories should not be operated 
if the temperature falls below 10 degrees C 
or 283 K. x/ 

*define MIN DESIRABLE TEMP 285 /* The heaters should be on if the temperature 
is below 285 K. x/ 

define MAX DESIRABLE, TEMP 287 /* The heaters should be off if the temperature 
is above 287 K. x/ 


Sdefine BUBDATA 0x40 /* I/0 port for the controller's bubble memory. */ 
Sdefine BUBCTRL 0x41 /* Control and status port for the BMC. x/ 


/* The following codes are commands to the bubble memory controller. */ 
#define BABORT 0x19 


define BINIT 0x11 

Sdefine BFIFORESET 0x1D 

Sdefine BHRBLREG 0x16 /* Write boot loop register. */ 

#de fine BREAD 0х12 

Sdefine BHRITE 0x13 

#define BLOPARM 0x0b /* Load parametric registers. */ 

#de fine BTRIES 30000 /* Bubble commands should be written this */ 


7* many times before giving up in disgust. */ 


/* The following are bubble memory controller status codes. */ 
#define BBUSY 0x80 
define BOPCOMPLETE 0x40 


#define BFAIL 0x20 

#define BTIMING 0x02 

Sdefine BFIFO 0x01 

#define BBUSYBIT 7 /* These constants specify which bit in the */ 
define BOPCOMPLETEBIT 6 /* BMC status bit is used for which purpose. */ 
#define BFAILBIT 5 

#define BFIFOBIT 0 

define BNEVER READY 0 

Sdefine BXFER GOOD 1 

define BXFER BAD 2 

#define PAGELENGTH 64 /* The number of bytes in a page of bubble memory. */ 


#define MAXPAGE 8191 /* Greatest valid bubble memory page number. x/ 


#define ADPOINTS 10 /* The number of analog quantities to be converted to 
decimal. */ 

#define STRLEN 7 7% Number of characters to allow for integer 
characters, including a null terminator. */ 

#define HSTRLEN 2 7* Number of characters to allow for hexadecimal 
characters*/ 


Sdefine HEXINTSTRLEN 4 /* Number of characters in a hexadecimal word. */ 
define DUMPHIDTH 16 /* Number of bytes in a line of a memory dump. */ 
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/* Bit definitions for port C of NSC810 fl. (Base address is Ox00.) 
Bit # MEANING 


5 Spare output. 

$ Power strobe output (Active high). 

3 One if no terminal is connected to the RS-232C port. 
Zero if a terminal is connected. 

2 Barometric pressure drop detection after launch 
factive high). 

1 Vibration detection at launchlactive high). 

0 Matched filter detection of Auxiliary Power Unit (APU) 


Prior to launch (active high). 
*/ 
define TERMON 0x08 /* Points to the terminal connection line in NSC810 #1, 
Port C, Pin 5. It is zero when the terminal is 
connected. x/ 


Sdefine BARO ON 0x04 /* Barometric pressure drop line. */ 
Sdefine VIB ON 0x02 /* Vibration detection line. */ 
fSdefine APU ON 0x01 /* APU detection line. x/ 


7* Bit definitions for port C of NSC810 #2. (Base address is 0x20.) 

Bit # Meaning 

5 RESET* line for the bubble memory. This line should be 
zero whenever power is applied to or removed from the 
bubble menory. It is one normally. The purpose of 
making it zero during power switching is to avoid havin 
to meet the strict requirements for power rise and fall 
tims which would be necessary otherwise. 

4 Power line for the bubble memory. This line is a one 
to apply powers a zero to remove it. 


3 End of analog to digital conversion. (Active high?) 

2 Spare input. 

1 Spare input. 

0 Heater control output (active high). 
*/ 
$define READCI1 0x02 /* Points to the NSC810 51, Port C, R/M register. */ 
Sdefine BCLRCl Ох0а /* Points to the NSC810 #1, Port C, Clear register. */ 
Sdefino BSETCl  0x0e /* Points to the NSC810 31, Port C, Set register. */ 
*define BCLRC2 0x2a /* Points to the NSC810 8382, Port C, Clear register. *#/ 
Sdefine BSETC2 0x2e /* Points to the NSC810 #2, Port C, Set register. */ 


#define PNRSTROBE 0x10 /* Points to the power board relay strobing line. To 
turn on a peripheral, you must strobe this line high 
for PHRDELAY * 10 ms. This line is NSC810 $1, 

Port C, Pin 4. x/ 


/* These are port addresses for the A/D converter. Character strings which 
identifiy these are defined in file "global.c". Be sure that changes 
in one place are matched in the other. */ 


Rdefine VOLTO 0x80 /* Voltage from #20 V bus. */ 

Sdefine VOLT1 0x81 /* Voltage from -20 V bus. */ 

$8define VOLT2 0x82 /* Voltage from *10 V bus. */ 

#def ine TEMPO 0x83 /* Temperature from shelf above BMC. */ 
Sdefine TEMP] 0x84 /* Temperature from underside of speaker. */ 
edefine TEMP2 0x85 /* Temperature from shelf above battery. */ 
$define TEMP 0x86 /* Temperature from batteries. */ 

$define TEMP4 0x87 /* Temperature from controller's backplane. */ 
Rdefime TEMPS 0x88 /* Temperature from card 8 of BMC. */ 

fdefine TEMP6 0x89 /* Temperature from card 9 of BMC. */ 
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fdefine PHRDELAY 2 /* The number of 10 ms units that the power board 
strobe should be applied to turn on a relay. x/ 

fdefine BUBRST 0x20 /* Points to the RESET* line in NSC810 #2, Port C, 
Pin 5. */ 

#define BUBPHR 0x10 /* Points to the bubble power line in NSC810 #2, 
Port C, Pin 4. x/ 

define BUBDELAY 5 /* Number of 10 ms units to wait when operating the 
bubble memory. */ 


define MDR1 0x07 7* See the documentation for a description of the */ 
#define ООВА1 0x04 /* use of these ports. */ 
#define DDRB1 0x05 

#de f ine DDRC1 0x06 

define TMOI1 0x18 

fdefine TOLB1 0x10 

define TOHBI 0X11 

define STARTOl 0x15 

define MDR2 0x27 

define DDRA? 0х2% 

#define DDRB2 0x25 

#define DDRC2 0x26 

#define TMO2 0x38 

#define TOLB2 0x30 

#define ТОНВ2 0x31 

define STARTO2 0x35 


define PRTDATA  OxcO /* Port number for data from RS-232C interface. */ 
Sdefine PRTCTRL  0xeO /* Port number for control information from RS-232C 
interface. */ 
#define PRTOUTRDY 0x01 /* Bit zero of the PRICTRL byte is a one if the printer 
is ready to accept data and zero otherwise. */ 
*define PRTRDY 0x02 /* Bit one of the PRTCTRL byte is a one if there is 
data to be read and zero otherwise. */ 
/* Bit meanings for the power status byte at address POWERIN. 
Bit f Meaning 
5 1 if heater circuit is off; O if it's on. 


4 l if matched filter (APU detection) circuit is off; 
O0 if it's on. 
3 lif analog to digital converter (A/D) circuit is off; 
0 if it's on. 
2 1 if voltage controlled oscillator (УСО) is off; 
0 if it’s on. 
1 lif solid state data recorder (SSDR) is off; 
0 if it's on. 


The same bit assignments apply to the power command byte at address POWEROUT, 
but the bits have a different meaning. A one in bits 1-5 is used to select the 
corresponding relay. A zero is used to cause that relay to be ignored. 

A one in bit zero causes the selected relays to be switched on. A zero in 

bit zero causes the selected relays to be switched off. 

x/ 


#define PWR_RELAYS 5 /* The number of power relay switches. */ 
#define POWEROUT 0x01 /ж Port address for power control board commands. */ 
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#ае+1ге POWERIN 0х21 /ж Port address for power control board status. */ 


Sdefine SSDROUT 0x00 7* Port address for SSOR commands. */ 

Sdefine SSDRIN 0x01 /* Port address for SSDR status. */ 

&define SSDROFF 0x02 /* The following are commands for applying or removing*/ 
define SSDRON 0x03  /* power.*/ 

fdefine VCOOFF 0x04 

define VCOON 0x05 

Sdefine ADOFF 0x08 

#de f ine ADON 0x09 

&define MATFOFF 0x10 

fdefine MATFON 0x11 

#def ine HEATOFF 0x20 

Rdefine HEATON 0x21 

$define ONBIT 0x01 /* The lowermost bit of a power command is 1 to turn 


power on, 0 to turn it off. x/ 

f&define NOPOHER 0xC1 /* Mask for upper 2 bits and bit 0 in power. These 
bits have no meaning when you examine the power 
board's status.*/ 


/* These are event codes used for logging events. */ 
7* Dont' alter these codes without adjusting show event() accordingly. */ 
7* A prefic C means COMMAND ISSUED. 

A prefix CF means COMMAND FAILED. 

A prefix CS means COMMAND SUCCEEDED. 

A prefix D means SOMETHING WAS DETECTED OR DONE. x/ 
define INITIALIZE 0 /* Start with aplomb. x/ 
fdefine CSHEEP 1 /ж SSDR was commanded to enter SWEEP mode. */ 
fdefine CSSHEEP 2 /* SSDR accepted a SHEEP command. */ 
Sdefine CFSWHEEP E /ж SSDR wouldn't accept a SWEEP command. */ 
Sdefine DSHEEP 4 /* The sweep was completed successfully. */ 
#de fine DAPUON 5 /* The auxiliary power unit was detected ON. x/ 
fdefine CSCROLL 6 /* SSDR was commanded to enter SCROLL mode. */ 
Sdefine CSSCROLL 7 7*® SSOR accepted a SWEEP command. */ 
Sdefine CFSCROLL 8 4* SSDR wouldn't accept a SCROLL command. */ 
#define DLAUNCH 9 /* A launch was detected. */ 
Sdefine CLAUNCH 10 /* SSDR was commanded to enter LAUNCH mode. */ 
Sdefine CSLAUNCH 11 /* SSOR accepted a LAUNCH command. */ 
f&define CFLAUNCH 12 /* SSDR wouldn't accept a LAUNCH command. */ 
S$define DPRESSURE 13 /* The pressure switch detected a pressure drop.*/ 
#define DNOOPCOMP 19 /* SSDR didn't report completion in the 

allotted time. */ 


define DOPCOMP 15 /* SSDR completed its SWEEP or LAUNCH mode. */ 
define DABORT 16 /* We think the mission was aborted. */ 
Rdefine CONSSDR 17 /* The SSOR power on command was issued. */ 


define CSONSSDR 18 /* The SSOR power on command succeeded. */ 
$define CFONSSDR 19 /* The SSDR power on command failed. */ 


Rdefine COFFSSDR 20 /* The SSOR power off command was issued. */ 
Sdefine CSOFFSSDR 21 /* The SSOR power off command succeeded. */ 
define CFOFFSSDR 22 /* The SSDR power off command failed. */ 

define COFFVCO 23 /* The VCO power off command was issued. */ 


$define CSOFFVCO 26  /* The VCO power off command succeeded. */ 
Rdefine CFOFFVCO 25  /* The VCO power off command failed. */ 


Rdefine CONVCO 26 /* The VCO power on command was issued. */ 
#define CSONVCO 27 /* The VCO power on command succeeded. */ 
Rdefine CFONVCO 28 /* The VCO power on command failed. */ 

define COFFAD 29 /* The AD power off command was issued. */ 
Sdefine CSOFFAD 30 /* The AD power off command succeeded. */ 
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define CFOFFAD 31 /%* The AD power off command failed. */ 


#define CONAD 32 /* The AD power on command was issued. */ 
fidefine CSONAD 33  /* The AD power on command succeeded. */ 
define CFONAD 34  /* The AD power on command failed. */ 
define COFFMATF 35 /* The MATF power off command was issued. */ 


define CSOFFMATF 36 /* The МАТЕ power off command succeeded. */ 

define CFOFFMATF 37 гж Тһе МАТЕ power off command failed. x/ 

define CONMATF 38 /* The MATF power on command was issued. */ 

#define CSONMATF 39  /* The MATF power on command succeeded. */ 

define CFONMATF 40 /* The MATF power on command failed. */ 

Sidefine COFFHEAT 41 /* The HEAT power off command was issued. */ 

8define CSOFFHEAT 42 /* The HEAT power off command succeeded. */ 

#define CFOFFHEAT 63 /* The HEAT power off command failed. */ 

#define CONHEAT 46  /* The HEAT power on command was issued. */ 

ftdefine CSONHEAT 45  /* The HEAT power on command succeeded. */ 

define CFONHEAT 46  /* The HEAT power on command failed. x/ 

fidefine READAD 47 /* Wa read the A/D's. x/ 

define TERMINATE 48 /* Finish gracefully. */ 

#define DUSERNOAPU 49 /* The user terminated the wait for the APUs. x/ 

define INVALIDCOMMAND 50 /* This code is regarded as invalid, and should 
never occur. It is provided to help in 
debugging the software. */ 

#define PRIORLAUNCH 51 /* If power is restored after the launch has already 
begun, then this mission status is assigned. */ 


#define CSRECORD 52  /* The RECORD mode command succeeded. x/ 
Sdefine CFRECORD 53 /* The RECORD mode command failed. */ 


/* Various constants used for setting the parametric registers. X/ 


fidefine BBLKLNM 0x10 7* Block length register MSB. 66 bytes/page. */ 

#define BBLKLNL 0x01 /* Block length register LSB. 1l page/transfer. */ 

#define BMBMSEL 0x00 7* Bubble memory select (MBM). Only 1 module 
connected. */ 

define BENREG 0x20 /* Enable register. Polling mode. */ 


define THOUSANDTHS 0x60 /* The ports for reading the date and time. */ 
define HUNDREDTHS 0x61 


Sdefine SECONDS 0x62 

#define MINUTES 0x63 

#define HOURS 0x64 

#define WEEKDAY 0x65 

define DATE 0x66 

define MONTH 0x67 

struct datetime Ç 7* This structure contains binary coded */ 
char month; 7* decimal data as defined for the National */ 
char dates 7* Semiconductor MM58167A Microprocessor */ 
char hour; Z% Real Time Clock. */ 
char minute; 
char second; 


char hundredths ; 
char thousandths 3 


23 

struct idatetime € 7* This structure contains the same */ 
int imonth; 7* information as the datetime structure, but*/ 
int idate; 7* in integer format. clockint() takes care */ 
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int ihour; /* of converting from BCD to integer format. */ 
int iminutes 
int iseconds 
int ihundredths; 
int ithousandths у 
); 


/* This structure describes the uses of the bits in the power relay control 
port. */ 
struct power port fmt < 


char 225 7% Upper two bits are not used. */ 

char heater: 15 /* Bit 5 - designates the heater circuit. */ 
char matched filter:1j; /* Bit 4 - designates the matched filter. */ 
char a_to_d:l} иж Bit 3 - designates the A/D circuit. */ 
char veo:15 /* Bit 2 - designates the VCO. */ 

char ssdr:1j /* Bit 1 - designates the SSDR. *#/ 

char relays on:1| /* Bit O - 1 to turn relays on, 


0 otherwise. */ 


2; 


/* This structure describes data stored in page zero of the controller's 
bubble memory. */ 
struct pageO0data { /* À template for data in page zero of the 
controller's bubble memory. */ 
char sweepstarted; /* FALSE if sweep not yet begun. 
TRUE if sweep has been started once. */ 
char launchdones /* FALSE if launch has not yet been detected. 
TRUE if launch has been detected. */ 


int page! /* Number of next page available for 
log data.*/ 
char halfpages 7* 0 if top half of next available page is 


empty, 1 otherwise. */ 
char full experiment; /* TRUE if the full experiment is to be performed, 
FALSE otherwise. */ 

/* We need to record the date and time when RECORD 
mode was last initiated if we are not performing 
the full experiment. */ 

struct datetime RECORD start time; 


2; 
иж This structure describes data stored in every block of a page in 


the controller's 
bubble memory, with the exception of page zero. */ 


struct log data { 7* A template for logged data. */ 
struct datetime clock; /* Time and date of recorded data. */ 
char event; /* A coded event. See #define section for 
codes. */ 


char atod{ADPOINTS]; /%* Coded A/D readings. Codes not yet defined. */ 
25 


/* This structure has BLOCKS PER PAGE log data structures in it. */ 
struct full log page € 

struct log data half page(lBLOCKS PER PAGE]; 
25 
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enum pwr cmd modifiers (/* These codes can be given to cmdlog() for */ 


issued = 0, /* processing. They show whether a power relay x/ 
succeeded 21, /* command was merely issued, or succeeded or */ 
failed = 2 7* failed. ж/ 


3j 


E. FILENAME BUBBLE.H 


/* This file contains global prototype declarations for the functions in 
"bubble.c". x/ 


extern void bpageset(int page); 

extern void bubemdmenut void); 

extern char bubinit(void); 

extern char bubio(char command,int page,char *buffer); 
extern void bubmenul void); 

extern char bub on(void); 

extern void bub off(void): 

extern char issububcmd(char command); 

extern void rdstatreg( void); 

extern void showbubbuff(ichar bufferí 1,char mode); 
extern void testpattern(char buffer[ 1); 


F. FILENAME BUBBLE.C 
/* bubble.c +#/ 


#include "bubrw.h" 
*include "vibro.h" 
Sfinclude "convert.h'" 
Sfinclude "expmnt.h" 
Sinclude "inout.h" 
*include "delay.h" 
Sinclude "newio.h" 
finclude "global.h" 


void bpageset(int page); 
void bubcmdmenul void); 
char bubinit(void); 
char bubio(char command,;int page,char *buffer); 
void bubmenu( void); 
char bub on(void); /* turn on power to the bubble card */ 
void bub offtvoid); 7* turn off the power to the bubble card */ 
char issububemd( char command); 
void rdstatregl void)3 
void showbubbuf f( char bufferl],char mode); /* display the bubble buffer. */ 
void testpattern(char bufferl1]); /* sets whole bubble 
buffer to character of users choice*/ 


PRISER IER URE ERR BHU BBE DE E EE FF EDE EE EE E EE DEE HEE FE EE E EE DE EEE EEE / 
/* See the bubble memory manual regarding the setting of the parametric 
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registers, which is what this function does. */ 
void bpageset(int page) 


€ 

eutput( BUBCTRL,BLDPARM); /* signal to BMC next 5 bytes to data port 
are for parametric registers  */ 

output(BUBDATA ,0xC1); /* one page to transfer BLR LSB x/ 
output( BUBDATA 0x10); 7% one FSA channel BLR_MSB x/ 
output( BUBDATA, 0x20); /* Enable register-enable read corrected data */ 
/* Mask off lower byte of page number. */ 
output(BUBDATA, page & Ox00ff)s 
/* Mask off higher byte of page number,» with a zero MBM. */ 
output(BUBDATA, (page >> 8) & 0х001+#); 

) 


//OOOCCCCOOOCXOOEOICROOUDCODOCOOOCOOOODOOOOOOOODOODOOOOODOOOODOOOOOOODODOOOOODOOOOOOOOOOO|C/ 
/* Select from a menu, and issue, a command to the bubble memory. x/ 
void bubemdmenul void) 
€ 
char data; 
static int  comnand[] = < 
BABORT, BLDPARM, BINIT, BFIFORESET; 
NULL, BHRBLREG 
3 
while (TRUE )¢ 
printf("Select a command to be issued to the bubble memory: nr 
A Abort B Load parametric registers C Initialize D FIFO Resetnr 
E Transfer 40 bytes of Oxff. F Write bootloop registernr 
Z Return to previous menu. nr"); 
data = tolowerí termint )); 
printf(i"Zc n r'",data); 


if (data == 'z') return) 


/* Issue bubble transfer command. */ 
if (data == 'e') ¢ 
if (bubxfer()) 
printf('"Transfer succeeded. n r“); 
else 
printfi "Transfer failed. nr"); 
continues 


/* Initialize parametric registers for page zero */ 
if (data == 'b') Ç 

bpageset(0); 

continue) 


/* Check for other valid responses */ 


if (data < 'a' || data > 'f') ¢ 
printf("Use a valid letter please. nr"); 
continue; 

) 


/* Issue the command indexed by the letter */ 
if (issububcmd( command! data-‘'a'])) 
printf "Command succeeded. nr"); 
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else 
printf("Command failed. nr"); 


EE 9E 9€ 9e 3 E E EE E EE E 9€ 9€ 9€ 3E E EEE E E HEE E E EE E 9€ EIE EJEE JE E E EEE HE HIE OX E E E EE EE E HE IE X X JEJE E CE 9E E EXE E E 
/* This routine initializes the controller card's bubble memory. 
Return FALSE if unsuccessful; TRUE otherwise. 
After power is applied to the bubble memory, call this routine. 
It implements the flow chart on pp. 4.9-4.9b in BPK 5V75A Protyping Kit 
User's Maual from Intel. x/ 
char bubinit(void) 


{ 
7* Clear the bubble memory registers. */ 
if t'issububcmd( BABORT ) ) < 
printf" ABORT command failed. nr"); 
return( FALSE); 
2 
delay(BUBDELAY ); /* Delay BUBDELAY * 10 ms */ 
bpagesetí0); /* Load the parametric registers of 
the bubble memory. */ 
if ('issububcmd(BINIT)) € /* Initialize bubble memory for use. */ 
printf{( "INITIALIZE command failed. nr"); 
returnt FALSE ); 
) 
if ('issububcmdt BFIFORESET )) € /* Reset FIFO buffer. */ 
printf("FIFO RESET command failed in bubinit(). nr"); 
return( FALSE }3 
) 
if (!bubxfer()) € /* Write 40 Oxff characters to the 
bubble memory controller. */ 
printf("40 byte transfer failed. Status: "); 
rdstatregí ); 
return( FALSE); 
) 
if ('issububcmdt BHRBLREG ) ) /* Put boot loop memory map into BMC. x/ 
returntFALSE); 
returnt TRUE ) у /* If you got this far, everything 
worked. */ 
2 


A PEHE ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЗЕ ЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ FE ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЗЕ IE PE JE E E PE JEDE E ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ ЭЕЗЕ // 
/* Perform normal input from or output to the bubble memory 
controller. */ 
char bubio(char command,int page,char *buffer) 
/* "command" can be BREAD to read; BWHRITE to write. X/ 
/* "page" is a bubble memory page mmber, from O to 8192. */ 
/* "buffer" is a pointer to a buffer of length PAGELENGTH. */ 


int js /* Counters. X/ 


/* Do not operate the bubble memory if the temperature is below 
MIN OPERATING TEMP. x/ 
if (colder, than( MIN, OPERATING TEMP )) 
returni FALSE); 
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i 


bub_on( ); 
if (tbubinit()) Ç 
bub offt); 
returni FALSE); 
) 
bpagesetlpage)) /* Set parametric registers for the desired page. */ 
if (command == BREAD) < 
bubreadt buf fer ); 
} else if (command == BHRITE) < 
bubwrite( buffer ) у 
2 
/* Wait for the BMC to finish emptying the FIFO buffer and return 
OPCOMPLETE. */ 
for (3205; j«BTRIESs**3) € 
if (input(BUBCTRL) & BOPCOMPLETE ) 


break; 
) 
1f (3 >= BTRIES) € 
bub off(); 
printft"Couldn't get an OPCOMPLETE from BMC. Status: "); 
rdstatreg(); 
returni FALSE); 
) 
bub of ft); 
printf("OPCOMPLETE received from BMC.nr"), */ 
return TRUE J; /* If you got this far, the I/O worked! */ 


LEHR EHH HHH HHH HH ЭЕ ЭЕ ЗЕ QE 9E IE 9E HE E JE JE E 9E 960€ IE E E EE EXE YE QE EE JE EM IE JE IE JE JE FE E E JE JE JE / 


void bubmenul void) 


‹ 


k 
B 
С 


N C = хх O Tm т O 


char dəta; 
static char success[] = { 
"Bubble was successfully initialized in bubmemul). nr" 
و3‎ 
static char failurel] = ¢ 
"Bubble couldn't be initialized in bubmenu(). nr" 
3, 
while (TRUE) < 
printft 
Turn bubble memory power on.nr 
Turn bubble memory power off.nr 
Initialize bubble memory for use (fully automatic)nr 
Be sure to turn the bubble memory power on, first.nr 
Issue one of a menu of commands to the bubble memory. nr. 
Enter data from Keyboard into buffer.nr 
Show buffer contents in ASCII format. nr 
Show buffer contents in hexadecimal format.'nr 
Copy buffer contents to bubble memory (write bubble memory). n r 
Copy contents of bubble memory to buffer (read bubble memory). n rm 
Display contents of bubble memory status register.nr 
Return to previous menu. nr"); 


data * tolowerí( termint )); 


printf(i"Zc n r",data)) 
switch( data }¢ 
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сазе 'а': 
bub, ont ); 
break 
case 'b': 
bub off); 
break; 
case 'c': 
if (bubinit()) 
printf( success }} 
else 
printf( failure); 
break; 
case 'd': 
bubcmdmenu( }5 
break; 
case 'e': 
testpattern( tempbuf fer); 
break; 
case 'f': 
showbubbuf f( tempbuf fer ASCII}; 
break; 
case 'g': 
showbubbu f f( tempbuf fer HEX); 
break, 
case 'h': 
if ('bubiol BHRITE;getpagenol ); tempbuffer)) 
printf(i"Write Failed. nr"), 
break, 
case 'i': 
if (!bubiot BREAD, getpagenot ) ; tempbuf fer )) 
printf("Read Failed. nr'); 
break; 
case 'j': 
rdstatreg( }5 
break; 
'z':i case '2': 
return; 
default: 
printf("Use a valid letter, please. nr"), 


case 


IMIR IIR IEC HAR AEE HERA IRIE HS РНС E EFE DEE EEE HEHE EE HE RE REE E FEE EK EK 7 
char bub on(void) /* turn on power to the bubble сага */ 


t 


output( BCLRC2,BUBRST )3 /* Apply a reset to the bubble memory.*/ 

output( BSETC2 ,BUBPHR ) ; /* Apply power to the bubble memory.*/ 

/* The following delays could be 100 ms (according to the bubble 
documentation) but did not work, so we used 300 ms. #/ 


delay( BUBDELAY )5 /* Wait BUBDELAY * 10 ms for a response. */ 
output( BSETC2,BUBRST )3 /* Remove reset signal. */ 
de lay( BUBDELAY )5 /* Wait BUBDELAY * 10 ms for a response. */ 


ORO EI IOI IEEE IEEE EI TIE IESE TEE SE IEICE IE E E E AE A E AE E E E AE E E BE EE ЖЕ Эк Ж ЭЕ ЭЕ Э-ЖЕ Ж ЭЕ ЧЕ ЭЕ ЗЕЕ ЗЕЕ 
void bub offivoid) /* turn off the power to the bubble card x/ 


€ 


issububemd(BABORT); /* Issue the "abort" command to the bubble card. */ 

output! BCLRC2 ,BUBRST ); 4* Apply a reset signal to the bubble memory 
before switching the power off. */ 

delayi BUBDELAY ); 7* Wait BUBDELAY * 10 ms for a response. */ 

outputiBCLRC2 ,BUBPHR ) ; /* Remove power from the bubble memory. */ 


E EE E EE EEE E EEE JE E EEE E EE E E EEE E E EK E EE EE E E E E E E EE E EK E E ECE E EE EE E EE E E E E EEE E E EEE 


/* Issue a command to the bubble memory controller. */ 
char issububcmdi char command) 


٤ 
int ij 
char status; 
1=03 7* Initialize this so it has a value even if BABORT 
is the command. */ 
7* Don't issue a command until the BUSY bit goes away. */ 
if {command != BABORT) € 
for (iz0;i « BTRIES;**i) € 
if (( inputiBUBCTRL)) & BBUSY) 
break; 
) 
2 
if (i >= BIRIES) ¢ 
printfi"Bubble controller stayed busy indefinitely in issububcmd! ). 
Status: "Js 


rdstatregl )3 
return( FALSE )5 

) 

output! BUBCTRL command ) ; 

/* Command is not accepted until busy bit goes to one. */ 

for li = 051 < BTRIES;**i)€ 

status * inputi BUBCTRL ); 
if ((status & BBUSY) || (status & ВОРСОМРІЕТЕ ) ) 
break; 

) 

4* For all commands except RESET FIFO and WRITE BOOTLOOP REGISTERS, 
you must get a BUSY bit to consider that the command was accepted. 
However, an OPCOMPLETE is okay; if you get it, proceed. Note: 
this is not the way the documentation says to do this. It says 
you must get BUSY set first. However, that didn't seem to work. x/ 

if t(i >= BIRIES) 

&& (command != BFIFORESET) && (command != BWRBLREG) 
&& ( status & BOPCOMPLETE )) € 

printf("Bubble command Zsh was not accepted. Status: ", 
c tohtl command ) ); 

rdstatregt ); 

returnt FALSE )5 

) 

/* Wait for the OPCOMPLETE status code. */ 

for (i = Osi < BIRIES3+#+i )¢ 

if Cinput(BUBCTRL) & BOPCOMPLETE ) 
breaks 

} 

if (i >= BTRIES) ¢ 
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printf("OPCOMPLETE from BMC never occurred for command Zsh. Status: ", 
ctoh!i command ) ) ; 
rdstatreg! ); 
returni FALSE); 
) else í 
returni TRUE ); 


E EDE E EE EE E EEE E E E E EE EE E E E E FE FEME JEJE ЗЕ ЗЕ PEDE E ЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕЗЕ ЭЁ ЗЕЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭСЗЕ / 
void rdstatregl void) 
‹ 

printft"Zs n r",ctoht inputt BUBCTRL 22); 


A AHHA IE KDI IE E E EEK ЗЕ ЭЕ HEE IE IE JEJEJE ЗЕ ЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЭЕ ЭЕ Э© ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ Э© ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ © ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ ЗЕ ЭЁ // 
void showbubbufftchar buffer( ],char mode) /* display the bubble buffer. 
ASCII format tries to print each character as if it were a 
printable ASCII character. 
HEX format is the correct option to use if not all characters are 
printable. */ 
/* Valid values for "mode" are ASCII and HEX */ 


€ 
int j; /* Dump contents in an 8 by 8 array. */ 
for (j=053j<PAGELENGTH; j++) < 
if (mode == ASCII) 
printf("Zc'" ;buffer[ 351); 
else € 
printf("Zs ",ctohtbuf fer 311); 
if ((0 == (j + 1) Z 8) && (j != 0)) 
printfi" nr"); 
) 
) 
printf(i" nr"); 
) 


S ARAR D DE E IE IE IE DE IE IE IE DE IE IE E JEE IE DE DE FE IE FE IE IE EIEE IE PE IE IE DE FE FE E JE E E E E E E E E HE PE FE FE FE JE E DE DE PEIE HE FE E EE E E EEE 
void testpatternl char buf ferl ]) 
/* sets whole bubble buffer to character of users choicex/ 


t 
char © 
char s(STRLEN]; /* Storage for itoal). */ 
int j; 


/* Make sure c has a value before checking its contents.*/ 
€ = шоу 
printf("Specify up to Zs characters to stuff into the bubble. n.r", 
itoal PAGELENGTH»s ) )3 
for (3205 j«PAGELENGTH; 35**) € 
If с =) 
c terminl J$ 
if (c T5 UR) € 
buffer(j] = c; 
printf("Zc",c); 
) else 
buffer[3] = ' '; 
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› 


) else 


buffer[31 = ' 'j 


printf("rn r") 


G. FILENAME BUBRW.H 


extern char bubxferlvoid); 
extern char bubread(char *buffer); 
extern char bubwrite(char *buffer); 


Н. FILENAME BUBRW.S 


3 bubrw. 


3define 
8define 


TRUE 
FALSE 


Oxf f 


0x00 


The definitions which follow are from the file "vibro contrlr headers bmc.h". 


code. 


Thus they are copied here and all C comments have been converted 


5 
3 Since they are used by C source code, they are incompatible with assembly 
5 
5 


to assembly language conments. 


Sdefine BUBDATA 0x40 у 1/0 port for the controller's bubble memory. */ 
define BUBCTRL 0x41 » Control and status port for the BMC. */ 
y The following codes are commands to the bubble memory controller. */ 
Sdefine BABORT 0x19 
#de fine BINIT 0х11 
#define BFIFORESET 0х10 
fdefine BHRBLREG 0х16 3 Write boot loop register. */ 
Sdefine BREAD 0x12 
fdefine BHRITE. 0x13 
define BLDPARM OxOb у Load parametric registers. */ 
#define BIRIES 30000 y Bubble commands should be written this */ 


y many times before giving up in disgust. */ 


3 The following are bubble memory controller status codes. */ 


&define 
#de f ine 
#de f ine 
#de f ine 
#de f ine 


Sdefine 
ede fine 
#de f ine 
#de f ine 


#de f ine 
#de fine 
#de fine 
#def ine 
#de f ine 


BBUSY 0x80 

BOPCOMPLETE 0x40 

BFAIL 0x20 

BTIMING 0x02 

BFIFO 0x01 

BBUSYBIT 7 3 These constants specify which bit in the */ 
BOPCOMPLE TEBIT 6 3 BMC status bit is used for which purpose. */ 
BFAILBIT 5 

BFIFOBIT 0 

BNEVER READY 0 


BXFER. GOOD 
BXFER, BAD 
PAGELENGTH 
MAXP AGE 


64 3 The number of bytes in a page of bubble memory. */ 
8191 3 Greatest valid bubble memory page number. */ 
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;Implement in assembly code a C routine to permit a very rapid transfer 
of forty bytes of Oxff to the bubble memory controller during its 
sinitialization. 
3char bubxfer(void) 
3 

export  bubxfer 

region code 


bubx fer: 
push ix 
1d ix,0 у ix €-- sp 
add ix»sp 
sIssue a FIFO RESET command 
1d a» $BFIFORESET 3 FIFO RESET command code. 
out ( SBBUBCTRL ),;a 
ld de ,Oxffff 3 Initialize a timeout counter. 
fifors_busy: y See if the command was accepted. 
in a»( $BUBCTRL ) 
rla ; Move busy bit into carry flag. 
jp c,fiforst accepted ; The busy bit is a l if the command 
3 was accepted. 
dec de 
xor a 3 Clear register a. 
or d y See if de is 0. 
or e 
3р nz,fifors busy 3 Check for busy bit again, since timeout 
3 not yet complete. 
1а a» $FALSE 3 Timed out without succeeding, so 
jp bxfer exit y return with a FALSE condition code. 
fiforst accepted: 
ld b,40 3 We need to transfer 40 bytes of Oxff 
ld a,0xff 
xfer: out ( $BUBDATA),a 
djnz xfer 
in a,( $BUBCTRL ) 


y The transfer succeeded if you got an Op Complete code 
y with the FIFO bit set, even with the timing bit (bit 1) set. 


and SBTIMING 3 Zeroize the timing bit. 
cp $BOPCOMPLETE | $BFIFO 3 Do we have operation complete? 
3р z,xfer ok y Yes. 
ld a» SFALSE y Unsuccessful transfer. 
3p bxfer exit 
xfer ok: 
ld a»$TRUE 3 Successful transfer. 
bxfer exit: 
pop ix 
ret 


3) 


;Implement in assembly code a C routine to permit very rapid input of 
3a page of data from the bubble memory. 
char — bubread(char *buffer) 
; 
export  bubread 
import  issububcemd 
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region 
bubread: 
Rcomment 
Register 


push 
ld 
add 
exx 
push 
ld 
ld 
exx 
ld 
push 
са11 
POP 
cp 
jP 
ld 
3P 
frok: 
ld 
out 
ld 
ld 
read status: 
in 
bit 
jr 
bit 
Jr 
bit 
jr 


ld 
jP 
timeoutl: 
or 
sbc 


jr 
ld 


ËP 
read: 

ld 
read byte: 
ld 
check_ fifo: 
in 
bit 


code 


usage: 


a Scratch space. 

Constant 1 for subtractions. 
Constant PAGELENGTH. 
Constant BTRIES 

char *buffer. 


bc 
de 
hl 
bc' 


ix 
ix 0 
ix»sp 


bc 
c ix*4) 
b,t ix*5] 


h1,$BFIFORESET 
hl 

issububcmd 

hl 

SFALSE 

nz,frok 
a,SBXFER_BAD 
exit 


a»SBREEAD 

1 SBBUBCTRL );a 
hl,S$BTRIES-1 
bc,1 


a,( $BUBCTRL ) 
$BBUSYBIT,a 
nz,read 


SBOPCOMPLETEBIT,a 


nz,read 
SBFAILBIT>a 
nz timeoutl 


a, $BNEVER READY 
exit 


а 
hl,bc 


nc,read status 
8,$BNEVER READY 


exit 


de, SPAGELENGTH-1 


hl,$BTRIES-1 


a,( SBUBCTRL ) 
SBFIFOBIT,;a 


ix <-- sp 


Access alternate registers. 
Save bc' 
bc' €-- char *buffer 


Return to primary registers. 
Issue the FIFO Reset command to the BMC. 


Quit if this command didn't work. 


A x w w w w 


مي مي بي بي مي w^‏ 


j 


j 


y Not busy. 


Issue the READ command to the BMC. 


Look for BUSY bit up to BTRIES times. 
Used for subsequent decrements. 


Get status from BMC. 

Was the command accepted? 

Yes, so read a block of data. 

Was operation complete? 
Yes, so read a block of data. 


Not busy» not done. Failed? 
Didn't fail. Don't Know why. Allow a 
timeout. 


Did fail, so quit. Return function 
completion code in register a. 


Reset the CARRY flag. 

Have we looked for a BUSY signal BTRIES 
times yet? 

No, so try again. 

Yes, so we timed out. Quit and return 
function completion code in register a. 


Prepare to read PAGELENGTH bytes from BMC. 
Prepare to check FIFO bit BIRIES times. 


Get status byte from BMC. 


Is the FIFO bit set, i.e. FIFO ready? 
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jr 
or 
sbc 
jr 
ld 
jp 
getbyte: 
in 
exx 
ld 
inc 
exx 
or 
ex 
sbc 
ex 
jr 
ld 


exit: 
exx 
pop 
exx 
pop 
ret 


у) 


sImplement in assembly code a 


nz,getbyte 

a 

hl;bc 
nc;check, fifo 
a,$BXFER BAD 
exit 


a,( $BUBDATA ) 


(фс),а 
bc 


a 

de hl 

hl,bc 

de;hl 

nc,read byte 
a,$BXFER GOOD 


y code in 


ix y Restore 


y Restore 


Yes, so read a byte. 
Reset the CARRY flag. 
No, so try again up to BTRIES times. 


= чоч 


Never got a FIFO ready» so quit. 


- 


w 


Read a byte from the BMC. 


Place the byte in the buffer. 
Point to the next position in the buffer. 


= = 


y Reset the CARRY flag. 

y Put contents of de in hl to permit use of sbc. 
» Have we read all the bytes yet? 

$ Restore usual contents to de and hl. 

» No, so get another one. 

$ Yes, so quit. Return function completion 
register a. 


alternate registers. 


ix register. 


C routine to permit very rapid output of 


ja page of data to the bubble memory. 


;char 
£ 
export 
import 
region 
bubwri te: 
#comment 
Register 


#endcomment 
push 
ld 
add 
exx 
push 
ld 
ld 
exx 
ld 
push 
call 
pop 
cp 


bubwrite 
issububcmd 
code 


usage: 


bubwrite(char *buffer ) 


a Scratch space. 


bc 
de 
hl 
bc' 


ix 
іх›0 
ix»sp 


bc 
с›(1х+%) 
Ь,(іх+5) 


hl;$BFIFORESET 
hl 

issububcmd 

hl 

$FALSE 


Constant 1 for subtractions. 
Constant PAGELENGTH. 
Constant BTRIES 

char *buffer. 


$ 1x <-- sp 
y Access alternate registers. 
» Save bc' 


» bc' «-- char *buffer 


y Return to primary registers. 
» Issue the FIFO Reset command to the BMC. 


sQuit if this command didn't work. 
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jp 
ld 
јр 
frok2: 
ld 
out 
ld 
ld 


nz,frok2 
a,$BXFER_BAD 
exit2 


а ,$ВИВІТЕ 
($BUBCTRL),a 
hl1,$BTRIES-1 
bc;1 


write status: 


in 
bit 
jr 
bit 
jr 
bit 
jr 


ld 
jp 
timeout2: 
or 
sbc 


jr 
ld 


jp 
write: 

ld 
write byte: 
ld 
check fifo2: 
in 
bit 
jr 
or 
sbc 
3r 
ld 
jp 
putbyte: 

exx 
ld 
out 


exit2: 
exx 


pop 
exx 


a,( $BUBCTRL ) 
$BBUSYBIT,a 
nz,write 


5 
y 
5 


Issue the WRITE command to the BMC. 


Look for BUSY bit up to BTRIES times. 
Used for subsequent decrements. 


Get status from BMC. 
Was the command accepted? 
Yes, so write a block of data. 


$BOPCOMPLETEBIT,a $ Not busy. Was operation complete? 


nz, write 
$BFAILBIT ‚a 
nz;timeout2 


a, $BNEVER READY 
exit2 


a 
hl;bc 


nc,write status 
a; $SBNEVER READY 


exit2 


de , SPAGELENGTH-1 


hl,$BTRIES-1 


a,( SBUBCTRL ) 
$BFIFOBIT,a 
nz,putbyte 

а. 

hl bc 

ne ,check_fifo2 
a, $BXFER.BAD 
exit 


a,(be) 
($BUBDATA},a 
be 


a 
de,hl 
hl, be 
de ,hl 
nc, write_byte 
a, $SBXFER_GOOD 


5 
y 
y 
) 
y 
5 


سي مي ڪي مي ي س 


5 


y 


5 


ч w w w w w سي‎ 


Yes, so write a blocK of data. 

Not busy, not done. Failed? 

Didn't fail. Don't know why. Allow a 
timeout. 

Did fail, so quit. Return function 
completion code in register a. 


Reset the CARRY flag. 

Have we looked for a BUSY signal BTRIES 
times yet? 

No» so try again. 

Yes, so we timed out. Quit and return 
function completion code in register a. 


Prepare to write PAGELENGTH bytes to BMC. 
Prepare to check FIFO bit BIRIES times. 


Get status byte from BMC. 

Is the FIFO bit set, i.e. FIFO ready? 
Yes, so read a byte. 

Reset the CARRY flag. 

No, so try again up to BTRIES times. 


Never got a FIFO ready» so quit. 


Get the byte from the buffer. 
Write a byte to the BMC. 
Point to the next position in the buffer. 


Reset the CARRY flag. 

Put de into hl to permit use of sbc. 

Have we read all the bytes yet? 

Restore usual contents to de and hl 

No, so get another one. 

Yes» so quit. Return function completion 
code in register a. 


Restore alternate registers. 
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рор ix y Restore ix register. 
ret 


у) 


I. FILENAME CLOCK.H 


7* This file contains external prototyping declarations of all functions used 
in "clock.c". x/ 


extern void clockint(struct datetime *clock,struct idatetime x*iclock); 
extern void clockreadístruct datetime *your clock); 
extern char clockcompare(struct idatetime x*clockl,struct idatetime *clock2); 
extern void clockset(struct datetime *clock); 
extern void clocksum(struct idatetime *result, 
struct idatetime *clockl, 
struct idatetime *clock2 }}3 
extern void dump_clockistruct datetime *clock )3 
extern void rtcivoid)3 
extern void show_waketime(struct idatetime *waketime )}5 
extern void testtimeoutívoid); 
extern char timeout(int delaytime,int measure); 


J. FILENAME CLOCK.C 
/* clock.c x/ 


$include 'vibro.h" 
#include “convert.h" 
#include “inout.h" 
finclude "newio.h" 
#include "global.h" 


void clockint{(struct datetime *clock,struct idatetime *iclock); 
void clockread(struct datetime *your clock); 
char clockcompare(struct idatetime *clockl,struct idatetime *clock2)}3 
void clockset(struct datetime *clock); 
void clocksum(struct idatetime *result, 
struct idatetime *clockl, 
struct idatetime *clock2); 
void dump clock(struct datetime *clock); 
void dump iclock(struct idatetime *clock); 
void get_timel(struct datetime x*date and time); 
void rtc(void); 
void show waketime(struct idatetime *waketime); 
char *strcpytchar *s1, char *s2); 
void testtimeout(void); 
char timeouttint delaytime,int measure); 


static char *months[] = { 
"x* Invalid month xx',"January';"February'" ,"March'' ,"April',''May'", "June" ; 
"July" "Augus t", "September" "October" "November" "December" 

5 
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 ЖЗЕЗЕЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ HEIE ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ // 
/* Convert a datetime structure to an idatetime equivalent. This allows 
arithmetic to be performed on dates and times. */ 
void clockint( struct datetime *clock,struct idatetime *iclock) 
‹ 
iclock->imonth = bed_int(clock->month )5 
iclock->idate = bed_int(clock->date }5 
iclock-»ihour = bed_int( clock->hour )5 
iclock->iminute = bed_int(clock->minute)} 
iclock->isecond = bed_int(clock->second )} 
iclock->ihundredths = bed_int(clock->hundredths )5 
iclock->ithousandths = bed_int(clock->thousandths )› 


О жж IA ISI AAI ASA BISA SII SNA ASAI IAI SA I IAPS AIPA DEAE IE AE ME IE EAE E RE AE JEFE BEDE AE DEAE ISS ISA IE ж ЭЕ ЭР I A 
/* This routine fills a clock structure with the current date and time. */ 
7* It will not worry about the hundredths and thousandths, but it will attempt 
to ensure that at least the seconds have not changed between the first 
and the last reads of the various clock registers. Thus the hundredths 
and thousandths should not be regarded as accurate, ever. */ 
void clockreadl struct datetime *your clock) 
‹ 
int is 


1 = 03 
do ¢ 
your clock-»thousandths s inputi THOUSANDTHS ) ; 
your, clock-5hundredths s input( HUNDREDTHS ); 
your. clock-»second inputt SECONDS ); 
your. clock-»minute input MINUTES); 
your. clock-5hour s inputlHOURS); 
your, clock-»5date = inputi DATE ); 
your_clock->month = input( MONTH J3 
) while (your_clock->second f= inputl SECONDS) && *«i «- 10 * TRIES); 


ж ЭЕЗЕЗЕ ЭЕЗЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ FEE E E EE E E E E E ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕЗЕ ЭЕ ЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЗЕ ЗЕ ЭЕ / 
Z% Compare two clock times. Return TRUE if the first is later than or 
equal to the second, FALSE otherwise. This routine ignores the 
hundredths and thousandths, since they are inaccurate. */ 
char clockcomparelstruct idatetime *clockl,struct idatetime *clock?2) 
{ 


int differences 


difference = clockl->imonth - clock2->imonth) 
/* This logic allows you to decide January comes after December. */ 
if ((difference + 12) 2 12 « 6 
&& difference '= 0) return( TRUE ) 
if (difference != 0) returni FALSE); 
if (clockl->idate < clock2->idate) returní FALSE); 
if (clockl->idate > clock2->idate) return( TRUE Js 
if (clockl->ihour < clock2->ihour) returnt FALSE J$ 
if (clockl-»ihour > clock2->ihour) return( TRUE )3 
if (clockl->iminute < clock2->iminute)} returni FALSE); 
if (clockl-»iminute » clock2-»iminute) return! TRUE J$ 


E 


if (clockl-»isecond « clock2-»isecond) return(FALSE ); 


returní TRUE ); 
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/* This routine sets the real time clock. */ 
void clockset(struct datetime *clock) 
t 
get time(clock); 
output( MONTH ,clock-»month); 
output( DATE »clock->date }3 
outputt HOURS ,clock-»hour ) 5 
output( MINUTES ,clock-»minute); 
output( SECONDS ;clock-»second); 


SAARA KI A H E E E EE E E E E E E PEIE IE IE IE E E PEPE ЗЕ ЭЕ ЭЕ 3 ЭЕ ЭЕ E IE E DE IE DE PE PE FE JE E ЗЕ ЗЕ © ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ © ЭЕ ЭЕ-ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ / 
/* Find the sum of two calendar periods. x/ 
void clocksumí struct idatetime *result, 

struct idatetime *clockl, 

struct idatetime *clock2) 


int maxdate; /* The last valid date in the month. x/ 


result->isecond = clockl->isecond + clock2->isecond; 
result->iminute = result->isecond / 603 
result->isecond Z= 603 
result->iminute += clockl->iminute + clock2->iminute; 
result->ihour = result->iminute / 60; 
result->iminute Z= 60; 
result->ihour += clockl->ihour + clock2->ihours 
result->idate = result->ihour / 243 
result->ihour Z= 24; 
result->idate += clockl->idate + clock2->idate; 
result->imonth = 1 + (clockl->imonth + clock2->imonth - 1) 4 123 
maxdate = ((result->imonth == ç) |] (result->imonth == 6) 
|] (result->imonth == 9) |] (result->imonth == 11)) ? 30 : 313 
/* The real time clock makes no provision for leap year, so leap years 
are ignored in this program (sigh!) */ 
maxdate = (result->imonth == 2) ? 28 : maxdates 
result->imonth += (result->idate - 1) / maxdate; 
result->idate = 14 (result->idate - 1) % maxdate; 
result->imonth = 1l * (result-»imonth - 1) 7 123 


LER IRINA IIIA AAI ISIS LALA I AA BAIA LEAS ANAS A AID AANA IBA NAA SAAN SNS AA AA ee AAA I Tf 
7* Print a clock structure. */ 
void dump clock(struct datetime *clock) 
t 
int hour, minute, second, date, month; 


hour bcd int(clock-»2hour); 
minute bed_int{clock->minute }3 
second s bcd int(íclock-»second); 
date 7 bcd intí(clock-»date); 
month 2 bcd int(clock-»month); 
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printf("Z02.2d:202.2d:402.2d Zs Zdn.r", 
hour ;minute,second, 
months{ month » 12 ? O : month ], 
date 
J; 


E EE EEE E EE EEE EEE E E E E E E EE E 3E 3E EE E E EE E HE EDE E EE EE FETE JE E E E EEE JE E DE BE FE ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ ЗЕ 3% ЭЄ ЭЕ ЗЕ ЭЕ // 


/* Print an iclock structure. */ 
void dump iclock(struct idatetime *clock) 


€ 
printf("/02.2d:402.2d:402.2d 7s Zdnr", 
clock->ihour ,clock->iminute,clock->isecond, 
months{ clock->imonth > 12 ? 0 : clock->imonth 1, 
clock->idate 
); 
J 


з= = ж KK KEK 3E Je 3€ 3E 3E JE 4 9E 3E 9€ 3E 4% 3E 3E 9E 96 9€ JE3IE 9E 9E 9E 9E 9€ 9E 9E 9E 933 ¥ 3C 3€ JE 3E JE 9€ 3E 3e 3€ Me 3E OE3IE e JE 3E E IE E IE 3E IE ж EE EHE EE B 
void get tine(struct datetime *date and time) 
t 

int month; date, hour, minute, second, maxdates 

static char crf} = "nr''y 


while (TRUE) € 
printft'"Month? (1-12) "); 
month * getintí); 
if (month >= 1 && month <= 12) 
break; 
printf("Invalid month. Re-enter it. nr"); 
) 
printfler); 
maxdate = (month == 4 || month == 6 || month == 9 || month == 11) ? 
БО 
maxdate = (month == 2) ? 28 : maxdate; 
while (TRUE) < 
printf("Day? t1-Zd) ",maxdate); 
date 7 getint( ); 
if (date >= 1 && date <= maxdate) 
break; 
printf(" n rInvalid date. Re-enter it. nr"); 
) 
printftcr); 
while (TRUE) ¢ 
printf€"Hour? (0-23) ")у 
hour * getint(); 
if (hour >= 0 && hour <= 23) 
break; 
printf("Invalid hour. Re-enter it. nr"); 
) 
printftcr); 
while (TRUE) € 
printf("Minute? (0-59) "); 
minute = getint(); 
if (minute >= Q && minute <= 59) 
breaks 
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printf("Invalid minute. Re-enter it. nr"); 
) 
printfler )3 
while (TRUE) ¢ 

printf("Second? (0-59) "); 

second = getint()3 

if (second >= 0 && second <= 59) 

break; 

printf("Invalid second. Re-enter it., пг"); 
) 
printflcr )3 
date_and_time->month s int, bcd( month); 


date and time-»date = int bcdt(date); 
date end time-»hour = int_bed(hour )3 
date and time-»2minute 2 int bcdlminute);s 
date, and. time-»second * int bcd! second) ; 


3C 3C 3€ 3€ 3€ 3€ 9€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 9€ 3€ 9€ 3€ 3€ 3€ 3€ 3€ 3€ 3€ 4€ 3€ 9€ 3€ 3€ 9€ 3€ 3€ 3€ 3€ 3€ 3€ 9€ E € 3€ 9€ 3€ 3€ 3€ 3€ 9€ 9 3€ 3€ 3€ 3€ 9€ 3€ 3€ 3€ 9€ 9€ EVAR ES | 


/* This routine is a menu-driven collection of routines for testing the 
clock functions. */ 
void rtclvoid) 
‹ 
char data; 


while (TRUE) € 
Printf( 
"nrReal time clock functions.nrnr' 
A Read Clock. nr 
B Set clock. nr 
C Test timeout() function. nr 
Z Return to main menu. nr"); 


data = tolower(termin())3 
printf("Zcnr'",data); 
switch (data) € 
case 'a': 
clockread( &clock )3 
dump_clock( &clock )3 
break; 
case 'b': 
clockset( &clock); 
break; 
case 'c': 
testtimeout(); 
break; 
case 'z': 
return; 
default: 
printf("Use a valid letter please. nr"); 
break; 
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/* This routine displays the wake-up time. */ 
void show waketimelstruct idatetime *waketime) 
‹ 
char s[STRLEN]; /* String for itoal) routine. */ 


itoal waketime-»imonth;s); 

printft"Wake-up time is:  nrMonth = 2s ",5); 
itoalwaketime->idate,s)3 

printf("Date = Zs ',s)j 
itoalwaketime->ihour,s)3 

printf "Hour = Zs ",s); 
itoalwaketime->iminute,s )5 

printf("Minute = Zs ",s)5 

i toalwaketime->isecond,s); 

printf "Second * Zsnr",s)j 
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/* This routine is used to test the timeout( ) function. */ 
void testtimeout! void) 


€ 
char data, /* А character entered from the keyboard. */ 
units; /* The units of delay. */ 
int delays /* The number of units of delay. */ 


while (TRUE) € 
printf("Test of timeout! ) function. nrnr 
Specify time units for delay: nr n r 
A Hoursnr 
B Minutesnr 
C Secondsnr 
Z Return to previous menu. nr"); 


data = tolower(termin( ))3 
print#( "Zc n r",data у 
switch (data) € 
case 'a': 
units = HOURS, 
break} 
case 'Ь': 
units = MINUTES; 
break; 
cese 'c': 
units - SECONDS; 
break; 
cese 'z': 
return; 
break; 
default: 
printf("Use a valid letter please. nr"); 
break; 
2 
printf(" n rHow many units of delay do you want? nr"); 
delay = getint( )5 
printf" n rStarting delay: nr"); 


clockread( &clock); 

dump clock! &clock); 
timeoutí(delay,units); 

while( !'timeout(NULL NULL) ); 
printf "Delay complete. nr"); 
printf "Zc", BELL )?; 

clockreadl &clock }5 

dump, clock! &clock); 
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/* This routine is used to initiate a timeout sequence, and to test for 
completion. To set the desired delay time, the parameter "delay" 
should be non-zero. To test for completion, "delay" should be zero (NULL). 
When setting the delay time, the function always returns TRUE. When 
testing for completion, it returns TRUE if the time has elapsed, FALSE 
otherwise. */ 
char timeout(int delaytime,int measure) 
/* "delaytime" is the length of the timeout. */ 
/* "measure" is the unit of measure of time. This can be 
MONTH, DATE, HOURS, MINUTES, or SECONDS. x/ 


static struct datetime timenow} 
static struct idatetime itimenow, waittimes 


/* Allow the user to interrupt by use of CTRL characters. */ 
allow ctrl interrupts(); 


clockread( &timenow]; 
clockint(&timenow,&itimenow); 
if (delaytime == NULL) ( /x If delaytime == NULL, then check to 
see if timeout period is over. */ 
return( clockcompare( &itimenow,; &waketime)); 
J) else ل‎ /* Otherwise» set the wakeup time. */ 
waittime.imonth = waittime.idate = waittime. ihour 
= waittime.iminute = waittime.isecond = 0} 
switchi measure) € 
case MONTH: 
walltime.imonth = delaytime; 
break; 
case DATE: 
walttime.idate * delaytime; 
break; 
case HOURS: 
waittime.ihour *» delaytime; 
breaks 
case MINUTES: 
walttime.iminute 
break; 
case SECONDS: 
waittime.isecond 
break; 


delaytime; 


delaytime; 


) 
clocksum( &saketime,&itimenow,&walttime)l; 
show_waketimel &waketime )3 
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returni TRUE ); 


K. FILENAME CONVERT.H 


/* This file contains external prototyping declarations for all functions 
in "convert.c". x/ 


extern char atohíchar *ascii); 

extern unsigned int atohexintíchar asciill); 
extern int atoiíchar xs); 

extern char *bcd ascíichar bcd); 

extern int bcd intícher bcd); 

extern char *ctoh{char byte); 

extern char int, bcdíint decimal); 

extern char *itoaíint n, char s[]); 

extern char tolower(int c); 

extern char *uitohíunsigned int word); 


L. FILENAME CONVERT.C 


/* convert.c */ 


$include "vibro.h'" 
$include "inout.h" 
8include "global.h" 


char atoh(char *ascii); 

unsigned int atohexint(char asciill); 
int atoilchar ws); 

char *bcd ascíchar bcd); 

int bcd intíchar bcd); 

char *ctohíchar byte); 

char int bcdiint decimal }3 

char *itoa(lint n, char s[]); 

char toloweríint c); 

char *uitohíunsigned int word); 


CÓ NUR Re He hn Re Qe IM Ke MI E АРЗА E EE E E E E EEE EE 9E IEEE EE EXE E 9€ E EE EE HE EE E E EE E E EEE HE HE EE EE EK ‚// 
/* This routine converts a two-byte ASCII string representing a valid 


hexadecimal byte into a single hexadecimal byte. */ 
[RE ET EE IE IEE EE IE IEE TEE IIE E E E E EE EE EE HE EE E EEE EE E ECCE U E X 5 3334 EJ IE XE eC E EE E E EE 


char atohíchar *ascii) 
/* "ascii" is a string representing a hexadecimal byte. */ 


int is 
char results /* The hexadecimal byte after conversion. */ 


result = 03 
for (12031 < HSTRLEN && asciili] {= NULL;**i) ( 
result *= 16; 
if ( '0' <= asciilil] #4 '9' >= аѕсіі[1]) 
result += asciili] - ‘O's 
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else if ('a' <= asciili] && 'f' >= ascii[i]) 
result += 10 + asciili] - ‘a's 
› 
return( result); 


HE E EE E EE EE E EE EÊ ЗЕ E EE EE EE EE E E E EEE E E EE EEE DEE EEE ЭЕ ЗЕ ЗЕ ЗЕЗЕ ЭЕ ЗЕ E EE EE EE EE EE E EEE EEE EEE // 

/* This routine converts a four-byte ASCII string representing a valid 
hexadecimal word into a single unsigned integer. */ 

LKR FAK AER IAAI HSA HAAS Ve ee Se E See VA ee Se E E E E EE E EE E E EE EEE E E YEE EE EE E HEE E E E E E E E EEE Г 


unsigned int atohexint(char asciil ]) 


‹ 
int ij 
unsigned int result; /* The hexadecimal word after conversion. */ 
result = 03 
for (iz05i «€ HEXINTSTRLEN && asciili] != NULL3++i) X 
result *= 163 
if ( 'O' <= asciili] && '9' >= asciiliJ) 
result += asciifi] - '0'; 
else if ('a' <= asciili] && ‘f' >= asciilil]) 
result ** 10 * asclilil - ‘a's 
} 
return(result); 
) 


CCCII OC E EE EE EEE HE EE E E E E IE E E E E E ЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ IMAI PEPE JE JE E HE JE HE FE FE JE JE JE E E PE E JE HE E E E E E E E 3E EF 7 
int atoi(char *s) /* convert string to integer */ 
t 
static int n, sign; 
sign = 1j 
n = O; 
switch (ws) ( 
case '-': sign = -l; 
case '*': **sj 
) 
while (*s >= '0' && ws <= '9') n = 10 * n + *s++ = '0'j 
return(sign * n); 
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/* Convert a byte of binary coded decimal data to character string format. */ 
/* No check is made to ensure that input data really IS in BCD format. */ 
char *bcd asc(char bcd)  /* Tested March 16, 1987 x/ 
< 

static char ascii[i]; 

int bcdint; 


bcdint = 0x00ff & ((int) bcd); /* Convert io integer. */ 
/* If the tens digit is a zero, put a blank in its place; 
otherwise, put an ASCII digit there. */ 
asciilfO] = (OxfO & bedint) ? 
(0x30 | (bedint >> 4)) : ' "у 
asciill]) 0x30 | ((bcdint & Ox0f)); /* Get the units digit. */ 
asciil2] = NULL; /* Terminate the string with 
a null. x/ 
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return(ascii)) 
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4* Convert a byte of binary coded decimal data to integer format. */ 
7* No check is made to ensure input data really IS in BCD format. X/ 
int bcd int(char bcd) /* Tested March 16, 1987. x/ 
/* "bcd" is the BCD character to be converted. */ 


int bcdint, result; 
/* Take the units by masking off the tens. */ 
7* Then throw away the units and keep 
the tens.*/ 
bedint = Ox00ff & tint) bcd; 
result = Ox000f & bedints 
/*Multiply the tens by 10, and add to result.*/ 
result += 10 * (bcdint »» 4); 
returni result); 


A HIEI E E E E E E JE E QE E E € € EXE € 9€ 9€ 9E E E EE 9€ JE E EEE IE 9E 9€ E JE IE JE JE JE JE JE 9E E E EXE EE JE JE MEIE JE JE JE JE IE JE JE JE JE E JE E E ME € 3€ 3€ J 


/* Convert a character to hexadecimal ASCII string format. */ 
char *ctoh(char byte} 


‹ 

static char asciilHSTRLEN]; 

int byteint, nibble, base; 

byteint = 0x00ff & (tint) byte); /* Convert to integer. x/ 

nibble = byteint >> 43 /* Get the tens digit. */ 

/* Find out whether the nibble is in the range [0-9], in which 
case its ASCII representation starts at 0x30 (68 decimal), or 
[10-15], in which case the ASCII representation starts at 
A = 0x41 (65 decimal). In the latter case, add the value of the 
nibble to 65-10 = 55. */ 

base = (nibble >= 10) ? 55 : 483 

asciil0] = base + nibbles 

nibble = byteint & Ox0f; /* Get the units digit. x/ 

base = (nibble >= 10) ? 55 : 48; 

asciill] = base + nibbles 

asciil2] = NULL; /* Terminate the string with 

a null. */ 

returnlascii }5 

) 
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иж This routine converts an integer to a binary coded decimal character. 
Since 99 is the largest legitimate BCD number, the argument "decimal" 
is taken modulo 100. x/ 
char int bcd(int decimal) 
/* "decimal" is the number to be converted. X/ 


int result; 
/* Make sure decimal is a positive number. */ 


decimal = (decimal < 0) ? -decimal : decimals 
decimal Z= 100; /* If decimal is too big, take 
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it modulo 100. x/ 


result = (decimal / 10) «« 4, /* Get the tens and shift them into the 
high order half of the byte. */ 
result += decimal % 10; /* Add in the units. */ 


return( (char ) result); 
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/* itoa - convert n to characters in s. 
This program is from TOOLWORKS C/80, Version 3.1, by Walt Bilofsky. */ 
char *itoalint n, char s{]) 
t 
static int c, k; 
static char *p, *q3 


if ((K = n) < 0) 
K = -K3 


xp++ = k Z 10 + '0') 
) while (k /* 10); 
if (n < O} wp++ = '—'у 
*р = 0; 
while (q € --p) Ç 
с = *qj *qet = *p3 *p = су ) 
return (s); 


PKK HH HI III IE IEE IE HE IE OC ECC JEJE JE JE E E E E E JE IE IE E E E E JE E E E JE IE JE JE JEJE JE IE JE JE IE JE JE JE E JE JÉ JE IE IE JEJE JEJE E E JE IE JE E E MEAE / 
/* tolower - if the input is in [A..Z], convert to lower case 

This program is from TOOLWORKS C/80, Version 3.1, by Walt Bilofsky. */ 

char toloweríint c) 


{ 
if ('A' «2 c && c <= 'Z') 
return (c * 0x20); 
return c) 

2 
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/* Convert an unsigned integer to hexadecimal ASCII string format. */ 
char *uitohl unsigned int word) 


t 
static char ascii[HEXINTSTRLEN + 1]5 
unsigned int nibble; 
int ij 
asciilHEXINTSTRLEN] * NULL; 
for (i705i « HEXINTSTRLEN; **i) € 
/* Get the current nibble, in order from most to least significant. */ 
nibble = O0x000f & (word >> (4 * (3 - i))); 
/* If nibble >= 10, convert it to a letter from 'A' to 'F'. 
If nibble < 10, convert it to a letter from '0' to '9'. x/ 
asciilil] = (nibble >= 10) ? ('A' + nibble - 10) : ('O' + nibble); 
) 
returntascii); 
J 
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М. FILENAME DELAY.H 


/* This file contains external prototyping declarations for all functions 
in "delay.s". */ 


extern void delay(int n); 


N. FILENAME DELAY.S 


y delay.s 
$ Adapted from a program by Mr. David Rigmaiden of the 
5 Space Systems Academic Group at the Naval Postgraduate School. 


Rdefine LOOPCOUNT 1041 
$ Delay for n hundredths of a second. 
» void  delayin) 


y int n; /* The number of hundredths of seconds of delay desired. */ 


export delay 
region code 


delay: push ix y tz15T. 
y Cause ix to point to the first parameter. 
ld ix, y +=16Т. 
add ix,sp } t=15T. 
ld Cel ix+0) y tz19T. 
198 Ь,(іх+1) y tz19T. 
LOOP1: ld de , $LOOPCOUNT y tz10T. 
LOOP 2: dec de y t» 6T. Count down to zero in LOOP2. 
14 asd $ t= GT. 
or е 5 t= GT. 
jp nz,LOOP2 y tz10T. Inner loop t=24T. 
dec bc } t= 6T. Repeat LOOP] until time is up. 
ld а,Ь $ t= GT. 
or c $ t= GT. 
jp nz,LOOP1 y tz10T. Outer loop t=(34+24*LOOPCOUNT JT. 
pop ix $ t=14T. Restore ix to its initial value. 
ret y tz10T. 
) 


Total Delay =(106+(34+24*LOOPCOUNT Jen JT. 


Solve m#10 ms = (1064+(34+24*LOOPCOUNT )¥n)T with T = 1/f = 400 ns to 
get n = LOOPCOUNT. f = 2.5 MHz. For m=100, LOOPCOUNT = 1041, leading 
to a delay of 1.0008 s for an error of 0.08%. For n=l, 

this leads to a delay of 10.05 ms instead of the 100 ms required, for 
and error of 0.57. 


w w w w w 


181 


О. 


FILENAME EXPMNT.H 


extern char ad readí char); 

extern int adtoint(char addata,unsigned long multiplier); 
extern void alter pageO0(struct pageQdata * pagezero); 
extern char bad idea to record(char show); 

extern char baro_switch( void); 

extern char checkprt( void); 

extern char colder_thanlint reference); 

extern void display data page(struct full log page * datapage); 
extern void display page0(struct pageO0data * pagezero); 
extern void do_sweep( void); 

extern void expmntívoid); 

extern void initialize(void); 

extern char listenívoid); 

extern char logevent(char event); 

extern void log menu(void); 

extern void read adívoid); 

extern void shut downívoid); 

extern void shut down no. logívoid); 

extern char ssdrmode(char mode); 

extern char ssdr status(void): 

extern char voltages low(void); 

extern char we launched|void); 


P. FILENAME EXPMNT.C 


4* expmnt.c x/ 


include "vibro.h" 
*include "clock.h" 
finclude "convert.h" 
*include "inout.h" 
*include "main.h" 
*include "power.h" 
*include "newio.h" 
*include "bubble.h" 
include "global.h" 


char 


ad read(char port); 


int adtoint(char addata,unsigned long multiplier); 


void 
char 
char 
char 
char 
void 
void 
void 
void 
char 
char 
char 
void 
void 


alter pageO(struct pageO0data * pagezero); 
bad idea to record(char show); 

baro, switchí( void); 

checkpr t( void); 

colder_thanlint reference); 
display_data_page(struct full_log_page * datapage); 
display pageO0(struct page0data * pagezero); 
do sweep(í void); 

expmnt(í void); 

initialize( void); 

listen(void); 

logevent(char event); 

log menut void); 

monitor heaters(void); 


void post launchíivoid)) 

void recordí void); 

void shut downívoid); 

void shut down no logí(void); 
char ssdrmode(char mode); 
char ssdr status(void)) 

void short experimentívoid); 
void show event(char event); 
char voltages low(void)) 
char we launched( void); 


EE EOE E E EN EAE HE I HH HII ORCI ETE IE TEESE E E EE E E E EK I III II IASI Є 
/* This routine gets data from the analog to digital converter. */ 
char ad read(char port) 


t 
outputiport,0); /* You must write to the port before you 
can read it. */ 
delay(1)3 
returníinputiport)); 
J 


кзз ж ЭЕ з E E E E E E E E E E E E HEE E HHH EXE QC EE DEDE IE JE JE HEH HE JE E HE HEH RHR REE HE HE HE E HC E E E 

/* This routine converts a byte of data from the A/D converter into an 
integer. In order to reduce the amount of code generated by the compiler, 
it uses no floating point operations. 

The routine assumes that the converted value lies on a line which passes 
through the origin and whose slope (in some arbitrary units) is given by 
the multiplier. Consequently, this routine always converts value of zer 
to zero. 

To obtain the correct multiplier amounts to calculating the slope and 
scaling it to permit integer operations to succeed. 

For example, assume that a value of 255 in the A/D converter (the 
maximum possible) represents 15V. A difference of l in the value 
read by the A/D converter represents 

15V / 255 divisions = 58.8235 mV/division. 
Multiply this by 1E6 and round off to get the basic multiplier: 

58.8235 * 1Е6 = 58824. 
Using this multiplier will give results in units of volts. To get units 
of tenths of volts, say, increase the multiplier by a factor of 10 to 
588,240. The result will be an integer representing the chosen units; 
the decimal point is implied to be to the left of the rightmost digit. 

To avoid an overflow upon multiplication, the multiplier should 
be kept less than 

(2**32)/255 = 16,843,009. 
The greates achievable accuracy is obtained when the multiplier is scaled 
up by multiplies of 10 as mich as possible without exceeding this limit. 
x/ 
int adtointtchar addata,unsigned long multiplier) 
‹ 
/* During compilation, this line will be flagged because it presents 
the possibility of truncation. The problem is not serious as 
long as the limit on the multiplier is observed, as discussed above. */ 
unsigned long value; /* A long integer version of "addata". */ 


value = (unsigned long) addata; 


183 


return((int) (((value * multiplier) + 5000001) / 10000001 ))› 


S HD E E E E DE EE E E E JEJE E E E HEDE IE FE FEIE JEDE PEE IE HE JE FE JE E E E PE HE IE JEJE IE ЗЕ ЭЕ ЭЁ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ E EE E € E E E EE E € € € € ЗЕ ЗЕ 3333 7 

/* This routine allows the user to alter the flags and pointers in page zero 
for the purpose of permitting program functions to be tested thoroughly. 
Use caution in altering them. */ 


void alter pageO0(struct pageO0data * pagezero) 


€ 
char data; /* Holds a character from the keyboard. */ 
char changes = FALSE; /* TRUE if the page zero needs to be altered, 
FALSE otherwise. We know that no unsaved 
changes have been made to page 0 before this 
routine is invoked, so we set this to FALSE 
initially. */ 
/* Nariable "flag" is used to permit the values 0 and 1 to be displayed 
as FALSE and TRUE respectively. */ 
static char *flagl] = { 
"FALSE", 
"TRUE" 
); 
/* Display this menu repetitively until choice Z is made. */ 
while( TRUE} € 
printf(" 
A Toggle 'sweepstarted' flag from Zs to Zs. nr 
B Toggle 'launchdone' flag from Zs to Zs. nr 
C Alter value of next available page from OxZx = Ха. пг 
D Alter value of next available half page from Zu to Zu. nr 
E Toggle 'full experiment' flag from Zs to Zs.nr 
F Specify the 'RECORD start time' (make this at least 12 hours before the nr 


present to permit RECORD mode to be initiated. )nr 
Z Exit this menu. nr", 
flaglpagezero-^sweepstarted ? 1 : O J, 
flaglpagezero-»sweepstarted ? 0 : 1 J, 
flaglpagezero-»launchdone ? 1: 0 ], 
flagl pagezero->launchdone 7 0: 1 J, 
pagezero-^page,; pagezero-»^page; 
pagezero->halfpage, 
(pagezero-»halfpage == 0) ? 1 : 0, 
flaglpagezero-»full experiment ? 1 : 0], 
flaglpagezero-»full experiment ? O : 1] 
J» 


/* Input a character, convert it to lower case, and display it. */ 
data = tolower( termin( ))5 
printf("Zonr",data)s 
switch (data) € 
case 'a': /* Complement the "sweepstarted" flag. */ 
pagezero->sweepstarted = !pagezero->sweepstarteds 
changes * TRUE; 
break; /%* Complement the "launchdone flag. *#/ 
case 'b': 
pagezero-»2launchdone = 'pagezero-»launchdone; 
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changes = TRUE; 
break; 

case 'c': /* Ask the user for a page number. Let this be the 

next page used for recording items in the log. */ 

pagezero->page = getpagenol }; 
changes = TRUE; 
break} 

case 'd': 7% Complement the "Һа1 раде" number. +#/ 
pagezero->halfpage = (pagezero->halfpage == 0} 7 1: 03 
changes = TRUE} 
break; 

case 'a': /* Complement the "full experiment" flag. */ 
pagezero-»5full experiment 3 'pagezero-»full, experiment; 
changes = TRUE; 
break; 

case 'f': 7* Ask the user for a new "RECORD start time". »/ 
get time(& (pagezero-»RECORD start time) )) 
changes = TRUE; 
break; 

case 'z': /* If any changes have been made, store them in page 

0 апа quit this routine. */ 
if (changes) € 
if (tbubiolBWRITE,0,(char *) pageO_buffer)) € 
printf("Update to page 0 failed. nr"); 


2 
) 
return; 
default: 


printfl"Use a valid letter, please. nr"); 
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/* This routine checks to see when RECORD mode was last initiated. 
If this time was within the last 12 hours, the routine returns TRUE, 
meaning that it is not a good idea to enter RECORD mode now. This 
will avoid a situation where RECORD mode is restarted in the middle 
of a mission, wiping out the recorded data. "show" must be TRUE to display 
the time when RECORD mode cam begin. If it is FALSE, the display is 
suppressed. */ 


char bad_idea_to_record(char show} 


‹ 
struct datetime current time; 
struct idatetime icurrent time; /* Integer version of 
current time. */ 
struct idatetime istored time; 7* Integer version of 
stored time. */ 
struct idatetime iRECORD delay time; /* Integer format of time when 


RECORD mode can begin. */ 
struct idatetime iRECORO delay constant;  /* Integer format of minimum 

time between successiva 

startings of RECORD mode. */ 


iRECORD_delay_constant.imonth = iRECORO_delay_constant.idate = 
iRECORD delay constant.iminute - iRECORD delay constant.isecond = 0; 


iRECORD, delay. constant.ihour - RECORD, DELAY; 


/* Get the current date and time and convert to integer format. x/ 
clockreadí &current time); 
clockint(&current time,&icurrent time); 


/* Get the date and time stored in the bubble memory as the last time 
that RECORD mode was initiated and convert to integer format. */ 
clockint(&(pagezero-»RECORD start time),&istored time); 


/* Add the two dates and times to get the next time when RECORD mode can 
be initiated. */ 
clocksum( &iRECORD. delay time,&istored time,&iRECORD delay constant); 


if (show) C 
printf("Current time:  '"), 
dump. clock( &current, time); 
printf("Time when RECORD mode last was begun:  '); 
dump. clock( & pagezero-»RECORD start time)])]; 
printf("Time when RECORD mode can be begun again: "Jj 


dump, iclock( &1RECORD, delay time); 


/ж Return TRUE if the current date and time is less than RECORD DELAY 
hours after the stored date and time. Otherwise, return FALSE. */ 
return(clockcompare( & 1iRECORD, delay  time,&icurrent time)l); 
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/* Check to see if the barometric pressure switch tripped. 
Make an entry in the log and return TRUE if so; return FALSE otherwise. */ 
A IH H I IE EE E 9E EE EXE 0E JE JE JE JE H IE IE IE JE JE JE JE JE JE E JE JE JE JE IE JEJE IE E JE JE JE JE JE JE JE JE JE JE JE JE JE JE IE JE E E E E JE JE JE JEME JE E JE JE E FE EXE COE / 


char baro_switch( void) 


‹ 
char addata; 7* Holds a character from port READC1. */ 
7* I the BARO_ON bit of the READC1 port is TRUE, then the barometric 
switch has been triggered. */ 
addata = іприї( ВЕАЮС1 ) 
if (addata & BARO ON) € 
printf('"Barometric switch triggered. n г"); 
logevent( DPRESSURE ) ; 
} 
} 
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/* This routine checks to see if there is a printer connected to the 
controller. It returns TRUE if there is one, FALSE otherwise. */ 

char checkprt( void) 


€ 
/* 1f the TERMON bit of the READCI port is 0, then a terminal 
is connected. In this case return TRUE; FALSE otherwise. X/ 
return(( input(READC1)) & TERMON); 
) 
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/* This function displays the data in page zero. */ 
void display page0(struct pageOdata * pagezero) 


t 


printf("Sweepstarted s "); 
if (pagezero->sweepstar ted) 
printf("TRUE "); 
else 
printf( "FALSE "J, 
printf("Launmchdone = "J5 
if (pagezero->launchdone ) 
printf("TRUE "); 
else 
printf( "FALSE "); 
printfi'"Full-expmnt = "); 
if (pagezero->full_experiment) 
printf “TRUE nr"); 
else 
printf "FALSE nr"); 
printfi"Last time RECORD mode was initiated: ")) 
dump_clock! &lpagezero->RECORD_start_time) ); 


printf(" n rNext page = Ox%«K = Zu", pagezero->page »pagezero->page )} 
printf("Next halfpage = OxZx * Zunr", pagezero-»halfpage, 
pagezero-^halfpage); 


LEEKS ASAI FHI HEI EE E E HE E E E E E E E E XQ XO EXE HEE E E E E E E E HIE EE / 


/* This function returns TRUE if the bubble memory's temperature is below 


the reference value; FALSE otherwise. */ 


char colder, than! int reference) 


c 


char addata; /* Holds a character from the A/D. */ 
int temperature; /* The current temperature in degrees K. */ 


7* Read in the temperature of the bubble memory. */ 
addata - ad read! TEMP4); 

temperature = adtoint(addata,MULT TEMP); 

return( (temperature < reference) ? TRUE : FALSE); 


LIAISE IA EI EASA AHI ASIA Se HINA E EE EE E EE PENI AAI IN E EEE EEE OCC / 


7* This function displays a page of data. */ 
void display_data_pagelstruct full_log page #баіараде ) 


t 


char addata; 7* Holds a character of data from the A/D. */ 

int pages /* The desired page number. */ 

int halfpages /* The current halfpage number.x*/ 

int is /* Counts through the valid A/D addresses. */ 

int values 7* The data from the A/D converted into useful 
units. */ 


printf(i"Which page of data do you want to see? nr"), 

page * getpageno! ); 

if ('!bubiol BREAD,page,log buffer1) € 
printf("Couldn't read page Zu. nr" page); 
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return; 

} 

printf("Contents of page Ox/x = Zd: n r",page,page), 

for (halfpagez0;halfpage « BLOCKS PER PAGE;**halfpage) ل‎ 
printf("Half page Zd: n r t" ,halfpage); 
dump clock( &(datapage-^half page[lhalfpagel.clock) ); 
show event( datapage-»half pagelhalfpagel.event ); 


/* "adcaption" is defined in file "global.c". x/ 
for (is0,i < ADPOINTS;,**1) € 
addata = datapage->hal f_pagel hal fpage).atodli Js 
printf("Z-24s=23.0d=",adcaptionl i ],addata ); 
if (i <= 2) ¢ /* The A/D reading is a voltage, in this case. */ 
value = adtoint(addata,(i-22)?MULT 10V : MULT. 20V); 
printf("ZcZ2.0d.Z02.0dV  ",(issz1)0?'-';'«*, 
value/100,valueZ100); 
} else { /* The A/D reading is a temperature, in this case. */ 
value = adtoint(addata,MULT_TEMP }5 
printf("Z6.0dK  ",value)) 
) 
/* Print two points per line. */ 
if ((0 !'2 12 2) || 1 ** ADPOINTS - 1) 
printft(t" nr"); 
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/* This function causes the "sweep" to be performed. */ 
void do, sweep! void) 


£ 


printf "Turn on SSDR and A/D Converter and place SSDR in SWEEP mode. nr"); 
logeventípower write( ADON) ? CSONAD : CFONAD)?; 
logeventípower writetSSDRON) ? CSONSSDR : CFONSSDR); 
logevent!(ssdrmode! SHEEP ) ? CSSWEEP : CFSHEEP ); 
printf("Wait 10 seconds before starting sweep. nr"); 
timeout( 10, SECONDS); 
/* Wait for timeout or for a Key to be pressed. */ 
whilet'timeoutt( NULL ;NULL)) € 
if (look ahead discardt )) 
break; 
J 
printf("Turn on VCO. Wait 13 minutes. n r"); 
logevent(power write( VCOON) ? CSONVCO : CFONVCO); 
timeout( 13,MINUTES); 
while (TRUE) < 
if (ssdr_status() == OPCOMP) < 
logevent( DOPCOMP )3 


break; 

} 

if (timeout(NULL;NULL) jj look ahead discard()) 4 
logevent( DNOOPCOMP ) ; 
break; 

J 


} 
printf("Sueep phase is over. Turn off VCO, A/D Converter, and SSDR. nr"); 
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logevent(power writelVCOOFF) ? CSOFFVCO : CFOFFVCO); 
logeventipower writelSSDROFF) ? CSOFFSSDR : CFOFFSSDR); 
logeventipower writel ADOFF) ? CSOFFAD : CFOFFAD); 
logeventi DSHEEP ); 


RRA RII OUI IIIB GREER RIE EIR IIR TE! 
/* This function performs the Vibro-acoustic experiment. */ 
void expmnt( void) 
€ 
char mission status; /* Can be DAPUON, DLAUNCH, DOPCOMP, DNOOPCOMP, 
or DABORT. Used to control program flow. */ 


if ('initializet)) < 
printf('"The bubble memory log is full. 


Running the experiment anyway. nr"); 
) 


иж Check to see whether we should operate the full experiment or пої. */ 
if ('pagezero-»full experiment) < 

short experimentt ); 

return; 


/* Check the sweepstarted flag in page zero of the controller's bubble 
memory. It's TRUE if the sweep has been started previously, 
false otherwise. */ 
if ('lpagezero->sweepstarted)) { 
printf "Starting the sweep. nr"); 
do sweep! )5 
) else ( 
printf("Saeep was done previously, so we're skipping it. nr"); 


7* Check the launchdone flag in page zero of the controller's bubble 
memory. It's TRUE if the launch has already taken places FALSE 
otherwise. */ 

if ('(pagezero->laumchdone)) € 

/* Keep on listening, until you detect either the APU, or the 
launch. If you run out of time, assume the mission 
was aborted. */ 
printfi"We haven't launched yet. Listening for the APU. nr"), 
mission_status = listenl )5 
printf(i"Turning on the SSDR, because listen() detected something. nr"); 
logeventípower writelADON) ? CSONAD : CFONAD); 
logevent(power write| SSDRON) ? CSONSSDR : CFONSSDR); 
if (mission status == DAPUON) ¢ 
printf("APU is on. Initiate a 10 minute timeout. nr. 
Placing 5508 іп SCROLL mode. nr"); 
logeventissdrmode(l SCROLL) ? CSSCROLL : CFSCROLL); 
timeout! 10,MINUTES); 
while (TRUE) ¢ 
if (we launchedl ) ss DLAUNCH) € 
printf "We launched. nr"); 
mission status = DLAUNCHs 
break; 
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› 
if (timeout(NULL,NULL} || look_ahead_discard{)) 4 
printf("We timed out and are aborting the mission. nr"); 
mission status - DABORT; 
logevent!DABORT ); 
break; 


) 
) else ( /* Launch was done previously. */ 
logevent{ PRIORLAUNCH ) 3 
mission status = PRIORLAUNCH; 
printf("We have previously launched and are in space now. nr 
Assume mission has been successfully completed..nr")3 
) 
if (mission status == DLAUNCH) < 
printf("Putting the SSDR in LAUNCH mode. nr: 
Initiating a 3 minute timeout. nr"); 
logevent(ssdrmode(LAUNCH) ? CSLAUNCH : CFLAUNCH)3 
timeout(3,MINUTES )5 
while (TRUE) ¢ 
/* If we haven't recorded a completed launch, check the barometric 
switch. If it has been triggered, then we should record one. */ 
if ('!pagezero->launchdone ) 
baro, switch(); 
if (ssdr status( ) == DOPCOMP) € 
printf("SSDR reported OP COMPLETE. n r"); 
logevent( DOPCOMP )3 


break; 
) 
if (timeout(NULL,NULL) || look ahead discard()) € 
printf("SSDR never reported OP COMPLETE. We timed out. nr"); 
logeventiDNOOPCOMP ); 
break; 
) 


) 
if (mission status 's: DABORT) 
post launchí); 
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/* This routine reads page 0 from bubble memory in order to initiate the 
experiment properly. */ 

char initialize(void) 
£ 

int is /* A counter which permits more than one attempt 

to read the bubble memory. */ 
char power port; /* Holds the status of the power subsystem. */ 


printf("Read from page 0 of the bubble memory. nr"); 
7* Attempt to read from page O up to BIRIES times before giving up. */ 
for(i=03'bubiol{BREAD,0,page0_buffer} && i <= BTRIESs++i)3 
display. pageO!pagezero); 
if (pagezero->page > MAXPAGE) ¢ 
returni FALSE); 
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for(i=03;i « BTRIES;**i) € 
iftbubiol BREAD,pagezero-»page,log buffer)) € 

print f( "logeventl INITIALIZE ) n r")5 

logevent( INITIALIZE )5 

power portzpower status(); 

if (VCOOFF & power port) € 
printf("Turning the VCO power subsystem off. nr"); 
logeventipower writelVCOOFF) ? CSOFFVCO : CFOFFVCO); 

} 

if (HEATOFF & power port) € 
logeventipower writelHEATOFF) ? CSOFFHEAT : CFOFFHEAT); 
printf("Turning the heater subsystem off. nr"); 

} 

returni TRUE ); 


) 
returni FALSE); 
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иж This function returns DAPUON if the APU is on; DLAUNCH if the shuttle 


has launched; FALSE if neither event is detected, but exit is forced by 
the pressing of any key on the terminal. */ 


char listen! void) 


€ 


char portcl; /* This holds the contents of NSC810 #1 port c.*/ 


printfl "Turning Matched Filter on. Wait for detection or a keystroke. nr"); 

/* Turn on the matched filter, and listen for the APU. If the matched 
filter is already on, this command has no effect. */ 

logeventi power_writel MATFON) ? CSONMATF : CFONMATF ); 

while (TRUE) € 


if (we launched!) 2* DLAUNCH) 
returni DLAUNCH ) ; 


portcl s ineutt READC1); 

if (portcl & APU ON) € 
printf "APU detection occurred. nr"); 
logevent( DAPUON) ; 
returnt DAPUON ) 


/* Exit this function if any key on the terminal is pressed. */ 
if (look ahead discardt)) 
re turni DUSERNOAPU ); 
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/* Log an event. This function returns TRUE if the event was logged 
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satisfactorily, FALSE otherwise. */ 


char logevent(char event) 


{ 


int ij /* A counter. */ 
char *buffer_ptr3 7* A pointer into the log page buffer. */ 
char fulls /* TRUE when all available pages are 


used up. */ 

buffer ptr = log buffer) /* Make buffer ptr point to the start of 
the log buffer. */ 

full = pagezero->page > MAXPAGEs 


/* I$ the bubble memory is full, there's no point in going on. Return. */ 
if (fu11) 
returni FALSE); 


/* Blank out the buffer if this is a new page. This guarantees that 
old data won't reside in the upper half-page when the new page is 
written to the bubble memory. */ 

if (pagezero->halfpage == 0) Ç 

for (is05;i < PAGELENGTHs++i) € 
(*buffer_ptr++) = 0x00; 


/* Fill the current log block with new data to be logged. */ 
clockread|( 
&l 
log_page-> 
half_pagel pagezero->halfpage ].clock 


)5 
log_page-> 
hal f_pagel pagezero->halfpage].event = events 


/* Read the A/Ds and put their contents in the log, too. */ 
for tiz0;i € ADPOINTS;i**) € 
log раде-> 
half pagelpagezero-»^halfpagel.atodli] 
? ad readtadport[ i1); 


if (event == CSSHEEP || event == CFSHEEP) € 
pagezero->sweepstarted = TRUE} 
) 
if (event == DPRESSURE) { 
pagezero->launchdone = TRUE} 
) 
/* Write the new page of data to the bubble memory. */ 
bubiot BHRITE ,pagezero-»page,log buffer); 
if (pagezero-^halfpage »* BLOCKS PER PAGE - 1) ( 
if((++(pagezero->page)) > MAXPAGE) { 
printf("'Bubble memory is all used up.in.r')3 
returni FALSE); 
2 
pagezero->halfpage = 0; 
J else 


++( pagezero->hal fpage }3 


/* Update page 0 in the bubble memory. */ 
bubiot BHRITE ,0,page0_buffer )3 


returnt TRUE ); /* If you got this far, you know you haven't yet 
run out of bubble memory. Return TRUE to show 


successful legging of an event. */ 
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/* This routine provides a menu of choices for examining or changing the 


contents of the bubble memory. */ 


void log menut void) 


‹ 


мо оь 


char data; /* Holds a character from the keyboard. 


/* Read page 0 from the bubble memory. */ 

if ('bubio! BREAD,O,pageO buffer)!) € 
printfít'"Couldn't read page 0. nr"); 
return; 


/* Display the menu repetitively until Z is chosen. */ 
while (TRUE ) € 
printf(" 
Display раде 0. пг 
Display a page of the 109. пг 
Alter the contents of page 0. пг 
Exit this menu.nr" 
Vy 
data = tolower({ termint ))3 
printft"7Zcn r",data); 
switch (data) ¢ 
case 'a': 
display. pageO(! pagezero); 
break; 
case 'b': 
display data, pageí log page); 
break; 
case 'c': 
alter pageO0!pagezero); 
break; 
case 'z': 
return; 
default: 
printf("Use a valid letter plesase. nr"); 


*/ 
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/* This routine monitors the temperature of the bubble memory used for 
logging data and operates the heaters to keep the temperature within 
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the desired range. */ 


void monitor heaters( void) 


€ 


char power, port; /* Holds the status of the power subsystem. */ 


power, port *» power status(); 
/* If it is cold enough, and if the heater is not yet on, turn it on. */ 


if (colder than(MIN DESIRABLE TEMP) && (HEATOFF & power port)) ¢ 
printf("Turn on the heaters. n c"); 
logevent(power write( HEATON) ? CSONHEAT : CFONHEAT ); 
return; 


/* It is is warm enough, and if the heater is already on, turn it off. x/ 
if ((!colder, than( MAX DESIRABLE, TEMP)) && (HEATOFF & power_port) ) ¢ 


printf("Turn the heaters off. nr"); 
logeventípower, write( HEATOFF) ? CSOFFHEAT : CFOFFHEAT ); 
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void post_launch( void) 


€ 


printf('"We're shutting down all power. nr"); 
shut, downt ); 
while (TRUE) ¢ 
printf("Reading A/Ds every 5 minutes. n c"); 
timeout(5,MINUTES); 
while (!timeout(NULL NULL )) € 
monitor, heaters( ); 
if (!pagezero->launchdone ) 
baro switch(]); 
if (look, ahead discard )) 
break; 
) 
logevent( READAD )5 
if (voltages_low()) Ç 
printf("Voltages are too low. Terminate the experiment. n r"); 
logevent( TERMINATE }5 
breaks 
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7% This routine performs the RECORD phase of the abridged experiment. */ 
void record(void) 


‹ 


printf("Entering RECORD mode. nr. 


Turning on SSDR and A/D Converter. nr"), 


/* Store current time in page 0. This is a record of the time when 
RECORD mode last was begun. The next time logevent() is called, 
the data will actually be stored in page 0. */ 
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clockreadi&(pagezero-»RECORD start time)); 
logeventipower write( ADON) ? CSONAD : CFONAD),; 
logevent( power_write(SSDRON) ? CSONSSDR : CFONSSOR); 
logeventissdrmodel RECORD) ? CSRECORD : CFRECORD); 
printfi"Initiating a 20 minute timeout. nr"); 
timeout 20, MINUTES )) 
while (TRUE) € 
/ж If we haven't yet launched, check to see if the barometric 
switches have fired or not. */ 
if ('pagezero-»5launchdone) ( 
baro, switch! ); 
) 
if (ssdr status( ) zz OPCOMP) € 
logevent( DOPCOMP ); 
breaks 
) 
if (timeout{NULL,NULL) |] look, ahead discardti )) € 
logeventi DNOOPCOMP ); 
break; 


› 

printf("Record phase is over. Turn off A/D Converter and SSDR. nr"); 
logeventipower_writel SSDROFF) ? CSOFFSSDR : CFOFFSSDR); 
logevent(power_write(ADOFF) ? CSOFFAD : CFOFFAD); 
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/* This routine operates an abbreviated version of the experiment which 


avoids doing the "sweep", and uses only RECORD mode in the SSDR. x/ 


void short_experiment( void) 


‹ 


char show flag; /* This flag is TRUE to make bad idea, to recordií) 
display computed times; FALSE otherwise. */ 
if tpagezero-»launchdone) ( 
printfi"He have previously launched and are in space now. nr"); 
logevent( PRIORLAUNCH )5 


while( !pagezero->launchdone) < 
4/* If RECORD mode was initiated too recently, we don't 
want to try it again. Wait for a suitable interval to elapse before 
continuing. bad idea to record!) knows how long this is. 
Alternatively, the user can press a key to avoid waiting. */ 


showflag * TRUE; /* Have bad idea, to record! ) display computed 
times the first time through. */ 
while (bad idea. to record! showflag)) € 
showflag * FALSE: 
if tlook ahead discardt)) 


break; 
) 
/* Wait for indications of a launch. */ 
listent )3 
7% Enter RECORD mode. */ 
recordt ); 
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if ('pagezero-»launchdone ) 
baro, switchí); 
} 
/* Now that we're in space, perform post-launch operations. */ 
post_launch( }5 
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/* This function displays the meaning of an event code. */ 
void show event(char event) 
t 
/* "event" is an index into the following array of messages. 
It is one of the event codes given in the "vibro.h" file. 
If someone changes it, someone had better change these messages to 
correspond, or the results will be disappointing.*/ 
static char *messagel] = Ç 
"Initialization. n r", 
"Sweep-mode command issued. nr", 
"Sweep-mode command accepted. nr", 
"Sweep-mode command not accepted. n r", 
"Sweep-mode completion detected. n r", 
"APU detected. nr", 
“Scroll-mode command issued. nr", 
"Scroll-mode command accepted. nr", 
"Scroll-mode command not accepted. nr", 
"Launch detected. nr"; 
"Launch-mode command issued. nr', 
"Launch-mode command acceptednr", 
"Launch-mode command not accepted. nr"; 
"Barometric switch detection. nr", 
"SSDR did not give OP COMPLETE within the allotted time. nr", 
"SSDR reported OP COMPLETE. nr", 
"Mission abort inferred. nr", 
"SSOR ON command issued. nr", 
"SSDR ON command succeeded. nr", 
"SSDR ON command failed.nr", 
"SSDR OFF command issued. n r", 
"SSOR OFF command succeeded. nr", 
"SSDR OFF command failed. n r", 
"VCO OFF command issued. n r", 
"VCO OFF command succeeded. п г", 
"VCO OFF command failed. nr", 
"VCO ON command issued. nr", 
"VCO ON command succeeded. nr"; 
"VCO ON command failed. n r", 
“A/D OFF command issued. nr", 
"A/D OFF command succeeded. nr"; 
"A/D OFF command failed. nr", 
"A/D ON command issued. nr", 
"A/D ON command succeeded. nr", 
"A/D ON command failed. nr", 
"MATCHED FILTER OFF command issued. nr", 
"MATCHED FILTER OFF command succeeded. nr", 
"MATCHED FILTER OFF command failed. nr", 
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"MATCHED FILTER ON command issued. nr", 
"MATCHED FILTER ON command succeeded. nr", 
"MATCHED FILTER ON command failed. nr", 
"BUBBLE MEMORY HEATER OFF command issued. nr", 
"BUBBLE MEMORY HEATER OFF command succeeded. nr", 
"BUBBLE MEMORY HEATER OFF command failed. nr"; 
“BUBBLE MEMORY HEATER ON command issued. nr”, 
"BUBBLE MEMORY HEATER ON command succeeded. nr", 
"BUBBLE MEMORY HEATER ON command failed. nr", 
"READ A/D command issued. nr"; 
"Experiment terminated. nr"; 
"User interrupted the wait for APU detectionnr.",; 
"Invalid command. nr", 
"Launch occurred before the last program initialization. n r", 
"RECORD mode command to SSOR succeeded. nr", 
"RECORD mode command to SSDR failed.nr." 

J; 

printf(messagelevent J); 
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7* This routine removes power from any relays which have it, and logs the 


fact. */ 
void shut_down( void) 
+ 
char power_port; /* Holds the status of the power subsystem. */ 
Power port * power status(); 
/* Remove power from all subsystems which currently have power. */ 
if (SSDROFF & power, port) 
logevent!power writetSSDROFF) ? CSOFFSSDR : CFOFFSSDR); 
if (VCOOFF & power port) 
logevent!power write(VCOOFF) ? CSOFFVCO : CFOFFVCO); 
if (ADOFF & power. port) 
logeventí(power write(ADOFF) ? CSOFFAD : CFOFFAD); 
if (MATFOFF & power, port) 
logeventtipower writelMATFOFF) ? CSOFFMATF : CFOFFMATF); 
if (HEATOFF & power port) 
logevent(power_write(HEATOFF) ? CSOFFHEAT : CFOFFHEAT ); 
) 
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/* This routine removes power from any relays which have it. It does not 
log the fact. */ 
void shut, down, no log! void) 
€ 
char power port; /* Holds the status of the power subsystem. */ 
power port - power status()j 
/* Remove power from all subsystems. x*/ 
if (SSDROFF & power port) 
power write(SSDROFF); 
if (VCOOFF & power. port) 
power write( VCOOFF ); 
if (ADOFF & power, port) 
power write(ADOFF ); 
if (MATFOFF & power port) 
power. write(MATFOFF); 
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if (HEATOFF & power port) 
power write(HEATOFF); 
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/* This routine sets the SSDR's mode. */ 
ё* "mode" is a coded SSDR mode. See file '"vibro.h". x/ 


char ssdrmode(char mode) 


c 
int ij 7* A counter. */ 
char status; 7* Hexadecimal status, used for debugging. */ 
/* Repeat the following code several times if the SSDR does not 
immediately appear to be successful. x/ 
for(i=0;i € TRIES;**i) ¢ 
Ooutputt SSDROUT ; mode ) ; /ж Output a mode command to the SSDR. x/ 
7* Wait for the SSDR to respond. */ 
delayt2]; /* Delay 2 x 10 ms to get a valid 
status. */ 
status = ssdr_status( J} 
if (status == NORMOP) ¢ 
7* Adding 1 to a mode gives the code for a successful operation. */ 
printf("SSDR returned NORMOP in response to command OxZx.nr"; 
mode); 
returnt TRUE ) ; 
) 
/* The SSDR did not confirm the proper mode was set. 
Try again. After you give up in disgust, signal 
failure by returning FALSE. */ 
) 
printf("SSDR did not return NORMOP in response to command OxZx.n r",mode); 
returnt FALSE); 
) 
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/* This routine gets the SSDR's status. */ 
char ssdr_status( void) 
{ 

returní input( SSDRIN)); 
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/* This function returns TRUE if the power supply voltages are too lows 
FALSE, otherwise. */ 
char voltages, lowt void) 
‹ 
int voltage; 7* Holds the voltage in hundredths of a volt. */ 
char addatas 7* Holds the voltage as read by the A/D. */ 


/* Read in the voltage on the 10V bus. */ 


addata = ad_read(VOLT2)3 
7* Convert to hundredths of a volt. */ 
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voltage = adtoint(addata,MULT. 10V); 

if (voltage «€ MIN VOLTAGE 10) € 
return( TRUE J» 

) 

returni FALSE); 


A AAEE E EE E EE E E EE E E EE E EE ЗЕ E EE E E EE EE HEEE EE EE EE E E E E EE E Ê EEE E E E E E Ê E EE EE ЭЕ ЭЕ ЗЕ XXX / 


char we_launched( void) 


t 
char portdata; /* Holds the port data. */ 
/* Check to see if the barometric pressure switch tripped. */ 
baro switchl); 
portdata = input(READCl); 
if ((VIB_ON | BARO_ON) & portdata) ¢ 
printf("Launch detected. Turning matched filter off. nr"); 
logevent( DLAUNCH ) 5 
logevent(power write( MATFOFF) ? CSOFFMATF : CFOFFMATF); 
return (DLAUNCH) ; 
) 
returni FALSE); 
2 


Q. FILENAME FPUTC.C 
/* fputc.c */ 


Sinclude "inout.h" 
Sinclude "vibro.h" 
*Sinclude "expmnt.h" 
include "newjo.h'" 


int fputctint chr, void *device); 


/* Bit 0 of the serial port is TRUE if the serial port is ready to write 
a character; FALSE otherwise. 
Bit 1 of the serial port is TRUE if the serial port is ready to read 
a characters FALSE otherwise. */ 

struct rs232c ( 
unsigned int :6; 
unsigned int read ready:1; 
unsigned int write ready:1j 

5 


/* Implementation of fputc() as described in the Uniware Compiler manual. 
For the NSC800 controller, there is only one valid output device, namely 
the RS232C terminal. The variable "device" is therefore ignored. 

This module must be place in unilib libc.a using the uar.exe utility. x/ 


int fputc(int chr, void xdevice) 
t 
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К. 


struct rs232c portdatas 
char port status; 


/* Allow the user to interrupt the display of data by use of control 
characters. */ 
allow_ctrl_interrupts( )5 


/* The UNIMARE manual specifies that this function must return -1 
if it cannot output a character. If there is no terminal attached, 
this is the case. */ 

if t !checkprtt)) 

returnt -1); 
do € 
/* Keep getting the status information for the RS232C data port 
until it is ready to accept data. */ 
port statuszinput( PRTCTRL); 
portdata = *(struct rs232c *) &port status; 

} while ('portdata.write_ready )5 

/* Otherwise; output the character and return it. */ 

Ooutput( PRTDATA,(char) chr); 

returni chr); 


FILENAME GLOBAL.H 


Z% This file contains external prototyping declarations of data used globally 
throughout the control program. */ 


extern char prtconnected; 

extern char tempbufferlPAGELENGTH ]5 
extern struct datetime clocks 

extern struct idatetime waketimes 
extern struct power_port_fmt power_ports 
extern char adport[ ADPOINTS]; 

extern char page0 buff^rlPAGELENGTH ]; 
extern char log buffer[PAGELENGTH]; 
extern struct pageO0data *pagezero; 
extern struct full log page *log page; 
extern char x*adcaptionl ]5 


5 


7® 
^* 


FILENAME GLOBAL.C 


global.c x/ 
This file contains the declarations of global variables needed by 
the control program. */ 


#include '"vibro.h" 


char prtconnected; /* TRUE if there is a terminal attached, FALSE 


otherwise. X/ 


char tempbuffer[PAGELENGTH]) /* A temporary buffer. */ 


struct datetime clock; /* The most recently read time will be 
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stored here. */ 


struct idatetime waketimes /* The most recently read integer version of 
time will be stored here. */ 


struct power port fmt power port; 


/* This is a list of A/D channels in use, and what they're used for. 
Make sure ADPOINTS = the number of transducers in use. */ 
char adport{ADPOINTS] = ¢ 
VOLTO, VOLT1, VOLT2> 
TEMPO, TEMP1, TEMP2, TEMP3, TEMPG, TEMPS» TEMP6 
ds 


char page0 buf fer( PAGELENGTH 1; /* A buffer for bubble memory page 0. */ 
char log buffer[PAGELENGTH]) /* A buffer for bubble memory log data. */ 


struct pageOdata *pagezeros 7* A pointer to the pageO_buffer. */ 
struct full_log page *log_pages 7* A pointer to the log_buffer. */ 


/* The following captions should match the A/D port assignments, 
in order. See the vibro.h header file.*/ 

char *adcaption[] = Ç 

"420V Bus", 

"-20V Bus", 

"«10V Bus", 

"T, shelf above BMC", 

“T, underside of speaker", 

"T, shelf above batteries", 

“T, batteries", 

“T, controller backplane", 

"T, card 8 of BMC", 

“Ту саган ыт ас! 
›› 


T. FILENAME INITIAL.H 


/* This file contains external prototyping decalarations for all functions 
in "initial.c". w/ 


extern void inithardwarel void)5 


U. FILENAME INITIAL.C 


иж initial.c */ 
Sinclude "vibro.h" 
include "inout.h" 


finclude "newio.h" 


void inithardwarelvoid); 
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/* This routine initializes the NSC810A ports. */ 
void inithardwarelvoid) 


‹ 


output(iMDR1;0x00); 


output( DDRA1 , Oxf f )5 


output( DDRB1,Oxff )5 


output( DDRC1,0x30)5 
output( TMO1,0x00 )3 


output( TM01,0x25); 


output(TOLB1,0x07); 
output( TOHB1,0x00); 


output( STARTO1,0x00); 


output(iMDR2,0x00); 


output( DDRA2 ,0x00); 


outputt DDRB250x00); 


output(DDRC2,0x31); 
output( TM02,0x00); 


output( TM02 0x25); 


output( TOLB2,0x01); 
output(i TOHB2 0x00); 


7% 


/* 


/ж 


/ з 


/% 
/* 


/* 


/* 


/* 


/* 
/* 


A 0x00 in the Mode Definition Register 

of NSC810 #1 puts port Al into basic I/O 
mode. */ 

Set port Al to output. 

Al is used to output command codes to 

the SSDR. */ 

Set port B1 to output. 

Bl is used to send commend codes to the 
power subsystem. */ 

Set port C1 to input/output. 

Bits are defined in vibro.h */ 

Stop timer O of NSC810A #1. You must do this 
before changing the timer's mode. */ 

Set timer mode to generate square waves 
without pre-scaling, and with single- 
precision selected, meaning only the low- 
order byte is ever read. */ 

Set low-order and high-order byte for timer. */ 
The modulus is thus 7. After 2*x(7*1) 
cycles, the timer is reloaded. Since the 
NSC800 clock has a frequency of 4.9152 Mhz, 
and this is divided by 2, the timer produces 
one pulse every 6.51 mus, for a 153.6 KHz 
signal. This signal is fed to the UART where 
it is divided by 16 te give a 9600 BAUD clock 
for serial communications. */ 

Restart timer 0 of NSC810A #1 by writing 
anything to it. */ 

A 0x00 in the Mode Definition Register 

of NSC810 82 puts port A2 into basic I/O 
mode. */ 

Set port A2 to input. 

A2 is used to read status codes from the 
SSDR. */ 

Set port B2 to input. 

B2 is used to read relay position codes 

from the power subsystem. */ 

Set port C2 to input/output. 

Bits are defined in vibro.hx/ 

Stop timer 0 of NSC810A #2. You must do this 
before changing the timer's mode. */ 

Set timer mode to generate square waves 
without pre-scaling, and with single- 
precision selected, meaning only the low- 
order byte is ever read. */ 

Set low-order and high-order byte for timer. */ 
The modulus is thus 1 decimal. After 2*(1*1) 
cycles, the timer is reloaded. Since the 
NSC800 clock has a frequency of 4.9152 Mhz; 
end this is divided by 2, the timer produces 
one pulse every 1.628 mus, for a 616.4 KHz 
signal. This signal is fed to the A/D 
converters. For a 640 KHz clock, the A/Ds 


will complete a conversion in about 100 mus. 
We are not far from 640 KHz, so should get 
comparable performance.  */ 

outputi STARTO2,0x00); /* Restart timer 0 of NSC810A #2 by writing 
anything to it. */ 

output(BCLRC2,0x30); /* Ensure that power is not applied to the 
bubble memory and that a reset is applied to 
it. This should be done when the NSC810 first 
receives power, but we leave nothing for 
granted. */ 


V. FILENAME INOUT.H 


/* This file contains external prototyping declarations for all functions 
ım inOGUt с x7 


extern void allow ctrl interruptsivoid); 
extern void dumplunsigned int address, unsigned int length); 
extern char gethex! void); 

extern unsigned int gethexintivoid)) 
extern int getintl void); 

extern int getpagenol void)» 

extern char look, aheadlchar *character); 
extern char look ahead discard!void)j 
extern void portdumpichar *string!; 
extern char terminl void)» 

extern void testinputivoid!],; 

extern void testoutput! void); 


W: FILENAME INOUT.C 
/*  inout.c */ 


include '"vibro.h" 
Sinclude "convert.h'" 
S$include "newio.h" 
S$include "bubble.h" 
Rinclude "expmnt.h" 
Sinclude "global.h" 
S$include "main.h" 


void allow ctrl interruptstivoid); 
void dump(unsigned int address, unsigned int length); 
char gethex(void)s 

unsigned int gethexint(void)s 

int getint( void); 

int getpageno! void); 

char look ahead!char x*character); 
char look, ahead discardivoid); 
char termin! void); 

void testinputivoid); 

void testoutputt void); 
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/* console buffer is shared by look ahead() and termint ). If look_aheadí ) 
reads a character in, it puts it in the buffer and sets the 
console data available flag to true. 
termin( ) will look first in the buffer for 
input from the console. If it finds any» it will set console_data to false 
and return the character in the buffer. Otherwise it will try to get a 
character from the console in the usual way. */ 

static char console, buffer; 

static char console data available - FALSE; 


EE HE HE Ê AAA E E E Û E Û EE E HE HC ИЕ ЭРЕЗЕ ERIN RBIS SISA ME BEDE E E PE Se BSI ISIN SPARES ABN RRS AMAL 
/* This routine processes the special characters CTRL S and CTRL Y from 

the keyboard. */ 
void allow ctrl interrupts(void) 


t 
char conchar; /* The character of console input data itself. */ 
char char available; /* TRUE if there is a character available for 
input from the console; FALSE otherwise. */ 
/* If there is a S character in the RS232C input port, then read it 
in using termini) and loop until another S is given. Thus, S 
serves as a toggle for stopping and starting output. */ 
/* See if there is a character available, 
and if so, put it in conchar.*/ 
char_available = look_ahead{( &conchar )3 
if (char_available) C 
switchtconchar) ¢ 
case CTRLS: 
case CTRLY: 
/* Call termin() to empty the buffer and handle the 
control character. */ 
termint); 
break; 
default: 
break! 
} 
) 
) 


JOOOOOECOOOOOOOOOOOOOOOOHODOOIOHOHOOOOOOOOOOOOOOOOOOIOOOOOIOOHOH/OOPOIHOÓOOOOOO / 
/* This routine produces a hexadecimal dump of any section of memory. */ 
void dump(unsigned int address, unsigned int length) 
{ 
unsigned int i; /* Points to the current byte being dumped. */ 
char asciifDUMPWIOTH+1]; /* Contains the ASCII equivalent of each byte. */ 


asciiflDUMPWIDTH] = NULL} /* Make sure ascii has a null delimiter 
to look like a C string. */ 
7* Convert length to a multiple of OUMPWIDTH. */ 
length = (length + DUMPHIOTH-1)/DUMPWIDTH) * DUMPHIOTHs 
for (1=0;i<lengthsit+) < 
if (Q==iZDUMPWIDTH) ¢ /* Dump the ascii version and start a 
new line every DUMPWIDTH characters. */ 


204 


11 (1 < 07 € 
printf("Zs n r"yascii)} 
J 
/* Also, dump the current address. */ 
printf("Zs:  ",uitohtaddress*1))j 
J 
/* Put extra spaces in the middle of each line. */ 
if (O0z2iZt DUMPHIDTH/2) && Q !* iZDUMPMIDTH) € 
printf(" "); 
J 
printf("7s ",ctohl*( char *) (address+i)))3 /* Dump each byte individually. */ 
/* Insert the current character in the string "ascii".*/ 
/* If it's not printable, replace it. */ 
asciiliZDUMPWIDTH) = *tchar *) taddress*i); 
if (ascii[iZDUMPHIOTH] < SPACE || ascii[iZDUMPHIDTH] >= DELETE) ( 
asciiliZDUMPHIDTH] s '.*'; 


) 
) 
/* Make sure ascii is printed again at the end of the last line. */ 
if (i>0) ¢ 
printfi"Zs n r",asciilj 
) 


A ЗӨЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ Э ЭЕ ЭЕ ЭЕ Э& Э-Э 3 E E E E Ê JE E E E E E E JE IE DE E E E JE IE JE IE JE IE JE JE JE JE JE JE JE JE JE JE JEJE ЭЕ ЭЕ ЭЕ E E JE JEJE JE ME ЭЕ A 
/* This routine gets a hexadecimal byte from the terminal.*/ 
A A m E E EDE E IE E E HE E E ЭЕ E IE E É ME E E ЭЕ ЭЕ Зе ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ 3€ € 9 363€ 3€ 96 3€ 3€ 3€ 9€ E 9€ 3€ 9E 96 96 36 3€ 9€ 963€ 9E 9E 969€ 9E 9 3E 2€ 3€ 9E 9696 € IESE EXC 9E / 
char gethex! void) 
‹ 

int 13 

char string[HSTRLEN * 1], 


stringlHSTRLEN] = NULL) 
for (i=0;i € HSTRLEN, **1) € 
stringli] = tolower( termint )); 
1f (string[i] == BS) Ç 
1 -= 2) 
if ti < -1) € 
і = -1, 
) else € 
printfi"b b"); 
) 
continue; 
) 
printf(i"Zc" ,string[il); 
if (stringli] >= 'a' £& stringlil «5 'f') 
continue; 
if (stringli] >= '0' && stringli] <= '9') 
continue; 
stringlil] = NULL, 
break» 
) 
returntatohistring))5 


S AAH KA H HHE EIEE E E E E E E E EE IE IE DE E E E E E E E E E E E EE E EK ЭЕ DE DE E EE E JE E E E JE JE JE JE JE E JE IE JE JE PE EJE HE FE E FE FE X AE / 


/* This routine gets a hexadecimal word (two bytes) from the terminal.*/ 
S IEIR E E E E E HE IE ЗЕЗЕ ЗЕ ЭЕ ЭЕ ЭЕ E ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЗЕ ЗЕ ЭЕ ЭЗЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ FE PE PE ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЗЕ ЭЕ ЭЕ ЗЕ ЭЕ ЖЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ / 


unsigned int gethexint(void) 


€ 
int ij 
char stringl HEXINTSTRLEN*1]1; 
string[HEXINTSTRLEN] s NULL; 
for (iz05i «€ HEXINTSTRLEN;**i) Ç 
stringlil = tolower(termint)); 
if (stringlil == BS) ¢ 
i -= 2; 
СЕТО C 
i = -l; 
) else C 
printf("b b"); 
) 
continue; 
) 
printf('Zc",stringlil); 
if (stringli] »* 'a' && stringlil «s 'f') 
continue; 
if (stringli] >= ‘O' && stringli] <= '9') 
continues 
stringli] = NULL} 
break; 
} 
return(atohexint(string))3 
) 


OCC ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ э э ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ 3 JE IE E FE E EE E JE E E E FE E JE FE FE FE E FE DE IE JE FE JE JE ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ // 
/* Get an integer from the terminal. x/ 
int getint(void) 
С 
int is 
char string(STRLEN]3 


string[ STRLEN] = NULL; 
for (1=051 < STRLEN;++i) Ç 
stringli] = termin( }3 
if (stringli] == BS) X 
i -= 25 
if (i < -1) Ç 
i = -l; 
) else € 
printf(i"b b"); 
) 
continue; 
) 
printf("Zc'" ,stringlil); 
if (stringl[il « '0' || stringlil » '9') < 
string[il = NULL; 
break; 
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returnl(atoilstring))5 


A AAIE HEIE E EDE E EE E E ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЗЕ ЭЗЕ IE PEIE E ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЭЕ ЭЕ ЗЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЁ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ FEFE EHE 
int getpagenol void) 


c 
int pages 
char s[STRLEN]1; /* Storage for itoal). */ 
itoal MAXPAGE s) 5 
printfi"Input the bubble memory page number (10-15 decimal):  '",s); 
while (TRUE) ¢ 
Page = getint( )5 
printfi" n r"); 
if (page >= 0 && page «s MAXPAGE) 
break; 
itoa( MAXPAGE , s) ; 
printf("Page must be in the range (0-Zs decimal):  ',s); 
) 
returni page); 
) 


JOE OX EE MEAE AEG e EXE EE IE E JE EE EXE EH EC EE EE FE HE IE E 9€ € 9€ E 9€ 9€ 9C9IE HC E HE E е X NXX XXX XX NSS KC E 3 36 E 
/* This function checks to see if a character is available through termini). 
It places the character, if any, in the location pointed to by 


'character'. It returns TRUE if there was a character, FALSE otherwise. */ 
char look_ahead(char *character ) 
€ 
/* If there is no terminal attached, return FALSE. */ 
if (!checkprt()) € 
returni FALSE); 
J 
/* If the buffer is already full, return it's contents, 
but don't empty it. */ 
if !console data, available) € 
*character 2 console buffer; 
returni TRUE); 
2 
/* Check the RS232C port to see if there is data available. 
Bit 1 will be 1 when data is present. */ 
if LinputiPRTCTRL) & PRTRDY) € 
/* If there is data, store it in the buffer and let termin! ) know 
about it by setting the console data available flag. */ 
*xcharacter = console buffer - inputiPRTDATA), 
returniconsole data available -» TRUE); 
) 
returni FALSE); /* No data was present. */ 
> 


RR RR کو کو ر ر چ چچ چ‎ а ЕЗ 0 ЭЭН ЭНН E EEE III er EE 
/* This routine checks to see if a character has been entered from the 
keyboard. If so, it discards the character and returns TRUE. If not, 
it returns FALSE. */ 
char look ahead discardi void) 
< 
if (look aheadl(ichar *) NULLJ) X 
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termin( )5 

returni TRUE ); 
) else 

returnt FALSE ); 


S RRR ERER EHDE PEER SE HEH HEEE KE KAE REEE EAE EAE AE AEA EE E E IE ERER RE DE EREE ЭЕ ЭЕ Ж HR RRA А ЗРНО 
/* This function obtains a character from the Keyboard. */ 
char termin(void) 
< 
static char allow menu call = ТЕЧЕ ; 


/* 'allow menu call' is true if menu( ) can be called from termini )s 
FALSE otherwise. It can be called from termin( ) once; subsequently; 
it must first return control to termini). Thus, one recursive entry 
into menu( ) is permitted at a time. The experiment can be monitored, 
but only at one subordinate calling level and no more. */ 


char waiting for ctls; 


7* This variable is true if an odd number of CTRL-S characters has 
been accepted. No characters can be accepted from the keyboard 
until an even number of them have been received. However, CTRL-Y can 
be accepted, in which case menuí ) will be called at once. */ 


char ctrl valid data; /ж This is TRUE if look ahead) already filled 
the buffers FALSE otherwise. */ 


waiting for ctls - FALSE; 
ctrl valid data * console data available; 


7* Loop continuously until an acceptable character has been received. */ 
while (TRUE) ¢ 
/* If the buffer is empty, then wait for a character to be entered. 
It could have been filled by look ahead! ).x/ 
if ('console, data, available) { 
while (TRUE) ( 
/* Check the RS232C port to see if there is data available. 
Bit 1 will be 1 when data is present. Wait for data. */ 
if (input(PRTCTRL) & PRTRDY) X 
console buffer * input(PRTDATA); 
break; 


) 

/* Now that console data has been read, set the availability flag 
FALSE so that if it becomes necessary to read another character, 
you can do so. */ 

console, data available s FALSE; 

switch (console buffer) € 

case (CTRLS): 
/* Toggle the waiting for ctls flag. As long as this flag 
is true, you can't get out of termin(). */ 
waiting for ctls * !waiting for ctls; 
if (('waiting for ctls) && ctrl valid data) 
returní console. buf fer ); 
break; 
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case (CTRLY): 
/* You can execute a CTRL-Y even if a CTRL-S is pending. 
The effect is to cancel the CTRL-S. */ 
waiting for ctls = FALSE; 
if (allow menu,call) € 
allow menu call = FALSE; 
4* Tell menu( ) not to start the experiment. This is 
only permissible when main() is the calling function. */ 
menu( 'EXPERIMENTOK )3 
allow_menu_call = TRUE; 
) 
if (ctrl valid data) 
returníconsole, buffer); 
break; 
default: 
/* Ignore this character if you're waiting for a second CTRL-S. x/ 
if (waiting, for ctls) < 
break; 
3 
return(console buffer); 


f EIE EIE EIE IE ЭЕ MEAE EIE IEEE QE E E FF E IE E E E E XE EIE EE OE E QE A 3E EE EE E EE EE QE E EXE IE EE E 3E 9E 3E E E EE EXE 3E E EXE EXE EXE E 


/* This fumction allows the user to read data from any port. x/ 
void testinputivoid) 


t 


int port; 7* Port number to be entered from the keyboard.*/ 
char data; 4* Data to be read from that port. */ 
printfi"Specify port address to be read (in hexadecimal): ^"); 
port s gethex(); /* Get the port address. */ 

printfi"nr"); 

data = inputiport); /* Read from the port. */ 


printfi"Data from port (in hexadecimal): Zs nr'",ctoh( data) ); 


JODIE OR E E CEE EE E E E FE E EE E FE E E EEE EE EE E EEE EE E E EE E E E E E E E E E E E E E E E E E E 


/* This routine outputs a character to a specified port. */ 


void testoutput( void) 


‹ 


int port; /* The port address. */ 
char data; /* The data to be sent to the port. */ 


printf("Specify port address to be written to (in hexadecimal): ")3 
port = gethex( ); 4* Get the port address. */ 

printf("nr")j; 

printf("Specify the data to be sent to the port (in hexadecimal): "); 
data = gethex( )5 

output(port,data); 


X. FILENAME MAIN.H 


/* This file contains external prototyping declarations for all functions 
in "main.c". x/ 


extern void memory dumpivoid); 

extern char menu(char experiment flag); 
extern void programi void); 

extern void testio(void); 

extern void main( void); 


Y. FILENAME MAIN.C 


/* main.c */ 


*include "version.h" 
include "vibro.h" 
include "bubble.h" 
$include "inout.h' 
S$include "power.h" 
#include "convert.h" 
#include "іпіїіа1.Һ" 
#include "clock.h" 
#include "newio.h" 
#include "global.h" 
#include “expmnt.h" 


void memory. dump(void); 

char menu(char experiment flag): 
void testiotvoid); 

void mainí void); 


Z F DE D D D MEE Ye Spo d dE De done Je GE E gode de de SE E E ge FE DE FE E E JE BoP E E GB. Be Be ee E Sec See Be Se Ê E Sos Go te Do E E E BPP GEA 
/* This routine lets the user produce memory dumps for any section of memory. */ 
void memory_dump( void) 
С 
unsigned int address; /* Will hold the starting address of the dump.*/ 
unsigned int length; /* Hill hold the number of bytes to dump.*/ 
while (TRUE) X 
printfi"Please specify address:  "); 
address = gethexint( )3 
printf(" n rPlease specify number of bytes to dump (0 to quit): "); 
length = gethexint(); 
printf(" n r"); 
iftlength zz 0) 
break; 
dumpi address, length); 


} 
IEE A A BEREE ERHI KOHETE HUG. SGI ISHII EE ET REE E REE Н 
/* This routine is the highest level of all the diagnostic menus. 
It will not permit the experiment to be run unless the experiment_flag 
is TRUE. */ 
char menu(char experiment flag) 
C 
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char data; /* A character read from the keyboard. */ 


int іу 7* À counter. */ 
char addata; /* A value read from the A/D converter. */ 
int values /* The A/D reading converter to useful units. */ 


while( TRUE) < 
versioni); 
printf(" 
Software reset. nr, 
Realtime clock functions. nr 
Power relay switching functions. nr, 
Bubble memory test functions.nr 
A/D converter functions. nr 
Run experiment.nr 
Perform port 1/0. nr 
Display contents of controller memory.nr 
Examine or change the data logged in the bubble memory.nr 
Exit this menu. n r") 


/* Read in a character from the keyboard, convert it to lower case, 
and display it. */ 
data = tolower( termin( ))5 
printfl"Zconr",data 3 
switch (data) € 
case 'a': /* To perform a software reset, jump 
to address 0. */ 
asm(" jp 0"); 
break; 
case 'b': /* Call the real time clock functions. */ 
rtcti); 
break; 
case 'c': 
pwurcnti)5 /* Call the power control functions. */ 
break; 
case 'd': 
bubmenut ); /* Call the bubble memory testing 
functions. x/ 
breaks 
case 'e': /* Display the A/D data. */ 


for (i=0yi < ADPOINTS;**i) € 
addata = аа геад! аброгї[і]); 
printf("7-26s273.0dz" ,adcaptionl il;addata); 


/* If i1 <= 2, then the A/D reading is a voltage. */ 
if (i <= 2) ¢ 
value = adtoint(addata,(i==2)}?7MULT_10V ; MULT 20V); 
printf(i"ZcZ2.0d.402.0dV  ",(isz:1)?'-':'«', 
value/100 ,value/100 )5 


/* Otherwise, the A/D reading is a temperature. */ 
) else Ç 
value * adtoint(addata,MULT, TEMP); 
printf("Z6.0dK  ",value); 
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/* Print two points per line. */ 
if ((0 t= i % 2) |[[{ i == ADPOINTS - 1) 
printf(" nr"); 
) 
break; 
case 'f': /* Execute the experiment, unless it 
is currently in a suspended state. */ 
if (experiment_flag) ¢ 
expmnt( )5 
} else Ç 
printfl"You cannot run the experiment functions while : 
execution is suspended with \Y. nrExit this menu and try again. nr") 5 


2 
break; 
case 'g': /* Enter the routine which reads from and 
writes to any port. */ 
testio(); 
break; 
case 'h': 
memory. dump( ); 7* Enter the routine which displays the 
contents of selected portions of 
memory. */ 
break; 
case 'i': 
log menut ); /* Enter the routine which permits the 
contents of the bubble memory log to 
be modified. +#/ 
break; 
case 'z': 
return; 
default: 


printf("Use a valid letter please! nr"); 
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/* This routine allows you to output data manually to any port, or to read 
data from any port. */ 

void testiolvoid) 


16 
char data; /* A character entered from the keyboard. */ 


/* Repetitively display the following menu until choice Z is made. */ 
while (TRUE) ¢ 
printft 
"nmrManual port I/O0 functions. Pick one! nr, 
A Input.nr 
B Output. nri 
Z Return to previous menu. nr”); 


/* Read a charecter from the Keyboard, convert it to lower case, 
and display it. */ 

data = tolower(termin( ))3 

printf("Zenr",data); 

switch(data) ¢ 
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сазе 'а': /* Enter the function which allows the 
user to read data from a port. */ 
testinput(); 
break; 
case 'Ь': /* Enter the function which allows the 
user to write data to any port. */ 
tes toutputt)j 
break; 
case 'z': /* Quit. x/ 
return; 
default: 
printf("Use a valid letter please.nr"); 
break; 


зе ж э ЭЕ ЭЕ ЭЕ Э-Э RR HH HHH HA JE € EE EE He E € 9€ € € EXE EE JE E JE IIE JEJE JE FE E IE JE JE JE JE JE E E E € E E E EXE JE E 9€ 9€9€ € EXE 9OX€ // 

/* The C program begins here. This routine gets control from the assembly 
language program which resides at address 0. */ 

void main(void) 


€ 
/* Make sure that each of these pointers is intialized to point to the 
Same memory as the corresponding buffer. Thus the same data can be 
accessed either as a list of characters (а buffer) or as a structure 
lif the contents need to be accessed individually.) x/ 
pagezero z (struct pageOdata *) page0 buffer; 
log_page = ístruct full log page *) log buffer; 
/* Initialize the system ports. */ 
inithardwarel }5 
/* See if there is a terminal attached. If so, turn off any subsystems 
which are currently on and enter the menu diagnostic system. */ 
if (prtconnected = checkprti)) € 
shut down no. log! ); 
while (TRUE) { 
menul EXPERIMENT OK )5 
) 
/* If there is no terminal attached, we must be in space, so run the 
experiment. */ 
) else 
expmntl )3 7* Run the experiment. */ 
) 


Z. FILENAME MBRK.S 
з тгк. 
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; mbrk() function for use with па110с( ) апа са11осі ). 

; File "spec" declares a single section of RAM, MRAMSZ bytes long, 

; to use for memory allocation; and START in file "start.asm" 

5 initializes MBRKPTR to point to that memory. 

$ 3€ JE JEJE JC JEJE JE He 3e Je HIC HE JE HE He JE E E EE EE E EEE HE E E E He E JC JE 3E Je Je He E E E E EE 3F E E E E EE E E E E E E E 3F E ¥ 3F ¥ ¥ 


global  mbrk,MBRKPTR,MRAMSZ 
option long=4 y assume longz4 bytes 
region code 
mbrk: push ix y char *mbrk( long size; long Xrealsize ); 
ld ix,0 
add ix,sp у (ix*6,5,6,7):sizo, lix*8,9):realsize 
ld de ; (eUHBRKPTR ) y return value is address of memory section 
ld asd 
or e 
jr zout } zero means memory section is in use 
ld а,(іх+6) 
ог (1+7) 
jr nz,out $ nonzero means more than 64K requested 
ld с›({1х+%@) 3 requested 'size' to bc 
ld b;,tix*5) 
14 Һ1,МВАМ52 y check if 'size' bytes are available 
y assumes MRAMSZ is less than 64K 
or a y clear the carry flag. 
sbc hl;bc 
jr c,out 
ld bc,0 y mark memory section as used 
ld (MBRKPTR),be y de still holds former MBRKPTR 
ld 1,(1x+8) y get the pointer to 'realsize' 
ld Һ,(1х+9) 
1а th1);lo MRAMSZ » write back actual size of memory section 
inc hl 
ld (h1),hi MRAMSZ 
inc hl 
ld (h1),0 
inc hl 
ld (Һ1 2,0 
jr ret » de is the return value 
очі: 1а de ,0 ; out of memory, return zero pointer 
ret: ld Sp»ix 
рор ix 
ret 


AA. FILENAME NEWIO.H 


extern char input(char port); 
extern void output(char port,char data); 


AB. FILENAME NEWIO.S 


$ newio.s 


input; output 
code 


export 
region 


y char input(char port); 


input: 
push ix 3There are no local variables. 
ld ix,0 
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ааа 1х›5р 


14 С›(1х+%) yPut port address in register c. 
in а›(с) 3Get the data from the port. 
рор ix sRestore ix to the value it had before this 


sfunction was called. 
ret 


» void output (char port, char data); 


output: 
push ix 
ld ix,0 sThere are no local variables. 
add ix,sp 
ld Crlix+G) sPut port address in register c. 
14 а›(1х+6) Put data in register a. 
out (с ),а yHrite the data to the port. 
pop ix ¿Restore ix to the value it had before this 
sfunction was called. 
ret 


AC. FILENAME POWER.H 


/* This file contains external prototyping declarations for all functions 
in "power.c". */ 


extern char power status!void); 
extern char power writelchar command); 
extern void pwrent(void); 


AD. FILENAME POWER.C 


/* power.c #/ 


Zinclude "“vibro.h" 
finclude "bubble.h" 
*include "convert.h" 
"include "inout.h" 
Sinclude "delay.h" 
Sinclude "expmnt.h" 
Sinclude "newio.h'" 
Sinclude "global.h" 


cher power status!void); 
char power writelchar command); 
void pwrent( void); 
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/* This routine gets the status from the power board. */ 


char power status void) 
t 
returnl( input( POHERIN)); 
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/* This routine sends commands to the power board. */ 


char power writeíchar command) 


€ 


int ij 

char status) 

char oncommand; /* TRUE if command is an ON command; 
FALSE otherwise. */ 

char relayons 7* TRUE if the indicated relay is on, 


FALSE otherwise. */ 
/* Try to send the command to the power board. 
Return TRUE if successful. Return FALSE after you give up 
in disgust. */ 
fortisOj;iX«TRIES;i**) Ç 

outputt POHEROUT , command ) ; 

outputtBSETC1,PHRSTROBE ) ; 

delay!PHRDELAY ); 

outputi BCLRC1,PHRSTROBE ); 

delaytPHRDELAY); /* Hait PHRDELAY x 10 ms for the 

relays to respond. */ 

/* The command is intended to turn a relay on only if the 
last bit is set (1). x/ 

oncommand - ONBIT & command; 

status - NOPOHER | power statust); 

/* To see whether the indicated relay is on, 
see whether only the status bit in the 
relay's assigned bit position is a zero. If it is» then 
that relay is on. */ 

relayon = status & command; 

/* If the relay's position matches that commanded, then 
log a successful setting of the relay. */ 

if t toncommand && relayon) || (*oncommand && !relayon)) ¢ 

returni TRUE ) ; 
2 
printf("Trying again to switch relays. nr"); 


/* If you got this far, then the relay's position did not match 
that commanded, so log a failure. */ 
returni FALSE); 


E EEK Û E HE EE EE E EE E EEE E E EE EE E EE EEE HE EE EE EEE EE E E E E EE E Ê EKE E EEE EE HEE EE EE EEE EK E EEE 


/* This routine sends commands to the power board. */ 
E E Û E EE EDE E E DE HE E E E EDED EEE EEE E L ALIS IAA IIA IIASA SA BIAS II AAAI NN ADNAN SIA INAS SAAN ADE | 


void pwrcnt(void) 


‹ 


сһаг data; 7*® Data from the keyboard. */ 
static int relay[J = < 
SSDRON, SSDROFF, VCOON, VCOOFF, ADON, ADOFF, 
MATFON, MATFOFF, HEATON, HEATOFF 
DIY 


whilet TRUE ) X 
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м хх C€ H X @ чт т осо Оо WO p> 


printf(" n rPOHER SHITCH CONTROL. nrnr. 
SSDR on. nr 
SSOR off.nr 
VCO on.nr 
VCO off.nr 
A/D on. nr, 
A/D off.nr 
MATCHED FILTER on. nr 
MATCHED FILTER off.nr. 
HEATER on. nr 
HEATER off.nr 
READ power status port.nr 
Back to the MAIN MENU. nr"); 


data » tolower! termin! )); 

printf(i"Zc n r",data); 

if (data »* 'a' && data <= '3') { 
ift!power write(relay[data-'a'])) 


printf("Power control command failed. n r"); 


) else € 
switch (data) { 
case 'k': 


printf("Zsn r'",ctohtpower, statust )))5 


break} 
case 'z': 

return; 
default: 


printf("Use a valid letter, please. nr"); 


break} 


AE. FILENANIESTART.S 


j E EEE E EE HE FEE ETE TE HE FETE E EE EE HE HE FE EEE E E E E JE JE EE E EE E EE FE HE FETE DE FETE TEBE HE HIE HE JE FETE TE IE E E E E E E OE E E 


5 
У 
) 
У 
$ 
) 
› 
) 
) 
) 


j EE FE E E EE E DE E EE EE E TE FE IE FE IE IE FE JE E IE HE FE TE IE JE IEEE E EEE EE EE ESE HEE SESE SHES FETE HEE FE TEESE HEISE. 


February 19, 1988 start.s 


This startup code initializes interrupt vectors and runs START at 


reset 


to initialize RAM and call the user function mainl). 

The companion link specification file is "spec" which defines 
many of the imported symbols. Also see file "mbrk.asm" for the 
mbrki ) function if you want to use malloct ) or calloct). 

The program is adapted from an example given in the UNIWARE 


manual, Compiler section, pp. 13-15. 


export  START,MBRKPTR 


import main,STACKTOP ,RAMDATA , ZRAM,ZRAMSZ , IRAM , IRAMSZ ,MRAM 
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$ HEIE JEJE E IEE E E E JE E E TE IE IE IEE JE ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ JE JE JE ЭЕ ME ME HEHE IE JE JE ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ HE IE PE JE ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ JE JE JE JEJE JEPE JE ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ 


; Define a variable to track memory allocations in mbrkí). 
$ E E E E E EE EEE JE DEE E E E HEHE JEJE JE HE JE JE IE JE JE JE JEJE JE ЭЕ ЭЕ ЭЕ ЭЕ JE JE JE JE JEPE FE JE JE JE ЭЕ JE HEE TE JE ЭЕ ЭЕ JEJE JE IE ЗЕ ЗЕЗЕЗЕ ЗЕ ЭЕ ЭЕ JE JE JE JE E EXE 


region ram 
MBRKPTR ds 2 $ (char *) to available memory 


p HE JEJEJEJE JE E EEE EEE JE ЭЕ ЭЕ E IE EEE EE IE E EE EE EEE EEE E EE JE IE X E EE E EE TEM EIEE JE ЭЕ E E ICE HEE HEEE EE EEE FE FETE 
$ Reset code must be linked to address 0. 


$ IEEE IE IE HE E E E E JE E EEE HEHE HE JE JEJE JE ЭЕ ЭЕ JE IE JEJEJE JE JE JE JE IE JEJE E EE EE EE E EEE E EE E JEJE JE JEJE IE ER EFE E EE E FEE EEE 
region reset 
ld sp, 10 STACKTOP 3 initial stack pointer (0x10000 as 0) 


jp START y initial execution address 
org 0x08 

ARESTART: yRESTART LOCATION 1 
jp START 
org 0x10 

BRESTART: sRESTART LOCATION 2 
jp START 
org 0x18 

CRESTART : sRESTART LOCATION 3 
jp START 
org 0x20 

DRESTART: sRESTART LOCATION 4 
jP START 
org 0x28 

ERESTART: $ RESTART LOCATION 5 
jp START 
org OxeC 

FRESTART: sRESTART LOCATION C 
jp START 
org 0x30 

GRESTART: sRESTART LOCATION 6 
jp START 
org 0x34 

HRESTART: sRESTART LOCATION B 
jp START 
org 0x38 

IRESTART: sRESTART LOCATION 7 
jp START 
org Ox3C 

JRESTART: yRESTART LOCATION A 
jp START 
org 0x66 

NONMASKI : $NON-MASKABLE INTERRUPT 
jp START 


QXSOBEHUODHHIEDHIUOUHUOUBHOOHBOBGHBHHUHHIBIHBGBHOEHHCBIBOHAHABIAO/OIBEHPOIOPOO| E 

3 This code can be anywhere; the reset code jumps to it. 

QIOGHBOOHOHGHBOOODOBHOGHBPBHOGHSO|HO/OIBOOBHOIHHHHEOHOBS HHHOHHHHIHIHC/HH/HH|BHH 
region code 


START: ld ix,0 3 end of stack frame chain 
14 hl MRAM 3 initialize memory allocator 
ld (МВВКРТВ )›Һ1 


j 3 HEHE IEEE E EEE E E E EE EE E E EE E E E EEE E EEE EE IE EE EE EEE EE E EEE E EE E EE EEE EEE 
$ Zero out uninitialized RAM. 
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) It is assumed here that ZRAMSZ > 1 but this is guaranteed 
) as long as MBRKPTR (above) is defined in region ram. 
J FEIE JE эе JE FEJE JEJE EE E € IESE IE EE SEE JE SE SEE SE SE EDI ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ Э ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ ЭЕ ЭЕ ЭЕ ЭЕ ЗЕ 


14 h1,ZRAM zero ZRAMSZ bytes here 


, 
1а (h1),0 j zero first byte 
1d de, ZRAH+1 3 repeatedly zero other bytes 
ld be , ZRAMSZ-1 
ldir 


j EE EE EEE E EE HEE ESE FE E EE EE EE EE EEE E E E E E E E E E E EE E E EE E EE E EE E E EE E E E E 3E E 


5 Initialize other RAM from ROM. 
наа за а CACHORRO ACH Mee SEED AE ЗЕ УЕЗ ЭЕ IE ROREM ROIG COUR E 
14 hl1,RAMDATA 
ld de IRAM 
ld Ьс,ІВАМ52 
1а a,b 
or c 
jr z,none 
ldir 
none 


j EF EF EE E JF EE E E E E FF E E E E E E EE E E E E JE IE E E E E E E E E E E E E E E E E E E E E FE FE E E € 3E E 3 AE 


; Invoke məin( ) with no arguments. 

9 3€ FE IE IE HE ECC JC 0E E E EE E HE E EEE E E E E E E E E E E FE JE FE IE FE IE JE JE IE IE FE JE HE IE IE IE FETE FE IE IE € E E HEE HE HE 

call main › апу return value is "int" in de 
done: halt » halt if main returns 


j E E PF E E E E E E E E E 9€ 3€ 9€ 9€ EXE € 9€ € € € 3E 3E E E E E E HE HE HH HH HH HH HE HHH HH HH HH RAH HHH KH RAKE HHH 

5 To vector an interrupt to a C function, you must go though 

j a register save routine like the one shown here. 

У If the "-r exx" option is being given to the command line, 

у then registers bc' de' and hl' need not be saved and restored 

У since the compiler will make no use of them. The compiler 

$ does not use af' in any case. 

j E EDE E E E E E E E E E C E IE E E E E JE FE IE EXE EXE OX FE E E E E E E E E EE E E E E E E E E E E TE FE FE E E E E FE HE E E E E EE HE HEHEHE 
region code 


INTERRUPT 

; push əf y save registers 
> push bc 

; push de 

у push hl 

3 push ix 

3 push iy 

b exx 

3 push bc 

3 push de 

3 push hl 

3 ехх 

$ са11 cfcn $ call some C function 
3 ехх 

3 pop hl y restore registers 
3 pop de 

3 pop bc 

3 exx 

3 Pop iy 

3 pop ix 

j pop hl 


рор de 


) 

$ pop bc 

› рор af 

) ei 

5 ret y» return from interrupt 


AF. FILENAME ASM.BAT 


Ərem Make asmsource the current subdirectory 

cd vibro contrlr asmsource 

arem Assemble the specified source file 

uasz80 -c 80 -n -t 4 -L 71 

3rem Place the object module in the object subdirectory 
copy *.o vibro contrlr object 

erase *.o 

Ərem Place the assembly listing in the list subdirectory. 
copy *.lst vibrocontrlr list 

erase *.lst 


AG. FILENAME ASMLIST.BAT 


arem Fill in the symbols of the specified assembly listing file 


гет with the values given in the executable module u.out. 
дгет Pipe the completed listing to the ulist program to give a 
3rem decent looking print-out. 


uabs vibro contrlr u.out < vibrocontrir list 41 | ulist >> temp print 


AH. FILENAME C.BAT 


arem Make csource the current subdirectory. 

cd vibro contrlr csource 

дгет Compile the source file. 

uccz80 -e -l -A -L -- 71 

дгет Place the resultant object module in the object subdirectory. 
copy *.o '"vibro contrlr object 

erase *.o 

arem Place the resultant assembly listing in the List subdirectory. 
copy *.lst vibro contrlr list 

erase *.lst 


Al. FILENAME LINK.BAT 


дгет Make object the current subdirectory. 

ed vibro contrir object 

arem Link the specified object modules together. 

ule -f spec -t -v 71 72 Z3 Ze Z5 Ze 77 78 79 

arem Place the linked module in the contrir subdirectory as u.out. 
copy *.out vibro contrlr 

erase *.out 

arem Create an executable module in the contrlr subdirectory as u.bin. 
cd vibro contrlr 

ufihex u.out > vibro.hex 


AJ. FILENAME LIST.BAT 


дгет Produce a paginated listing of the specified file, and 
drem put it in a temporary, scratch file called temp print. 
ulist -d -t 4 -x -0 hdrzZ1 71 »» temp print 


АК. FILENAME LOADMAP.BAT 


дгет Create a load map of all the regions in u.out. 
unm -m vibrocontrlru.out » temp temp 
гет Produce a paginated print-out of it. 


ulist -d -O hdr=loadmap temp temp >> temp print 


AL. FILENAME PRINTALL.BAT 


dren Produce a complete listing of the load map, symbol table and 
dren all source files, and header files. 
cd vibro contrlr 
call readyout 

call loadmap 

call promsym 

call o 

call list spec 

call h 

call list version.h 
call cs 

call list version.c 
call h 

call list vibro.h 
call list bubble.h 
call cs 

call list bubble.c 
call h 

call list bubrw.h 
call s 

call list bubrw.s 
call h 

call list clock.h 


са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
call 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 
са11 


cs 
list 


list 
cs 
list 


list 


list 


list 
cs 
list 


list 
cs 
list 


list 
cs 
list 


list 
cs 
list 


list 
cs 
list 


list 


list 


list 


list 
cs 

list 
list 
list 


list 
list 
list 
list 
list 
list 
list 
list 
list 
list 
list 
list 
list 
list 


clock.c 
convert.h 
convert.c 
delay.h 
delay.s 
expmnt.h 
expmnt.c 
global.h 
global.c 
initial.h 
initial.c 
inout.h 
inout.c 
main.h 
main.c 
mbrk.s 
newio.h 
newio.s 
power.h 
power.c 
s.bat 
start.s 
asm.bat 
asmlist.bat 
b. bat 
backup1.bat 
backup2.bat 
c.bat 
cs.bat 
link.bat 
list.bat 
loadmap.bat 
o.bat 
printall.bat 


promlib.bat 
promlink.bat 


кә 
to 
to 


call list promsym.bat 
call list readyout.bat 


AM. FILENAME PROMLINK.BAT 


cd vibro contrlr object 
link -F linkfile libc.a 


AN. FILENAME PROMOUT.BAT 


drem Put the print scratch file into the printer queue. 
copy vibro contrlr batch lpfont+ temp print* vibro contrlr batch normfont temp print2 
print temp print2 


AO. FILENAME PROMSYM.BAT 


dren Put the symbols from u.out into a scratch file. 
unm -fnrstv*gx vibrocontrlr u.out > temp temp 
гет Produce a paginated version of the symbol table listing. 


ulist -d -O hdr=symbols temp temp >> temp print 


AP. FILENAME READYOUT.BAT 


ðrem Get rid of the two scratch files used in producing listings. 
erase temp temp 

erase temp print 

erase temp print2 


APPENDIX I. RS-232C INTERFACE PIN CONNECTIONS 


This appendix contains the complete electrical specification for the RS-232C Inter- 
face. It is provided here for convenience. Only a subset of this specification has been 
implemented in the Vibro-acoustic Experiment for the purpose of providing communi- 


cations between the controller and the terminal, which 1s useful during ground testing. 


Table 16. RS-232C INTERFACE PIN CONNECTIONS 


Mne- 
monic 
Desig- 
nation 


Pin Circuit 
Desig- 
nation 


Direction Description 


Number 


FRAME GROUND. This lead is 
an electircal equipment frame and 
power ground. 


TRANSMITTED DATA. This 
lead carries the serial digital data 
transmitted from the DTE to the 
BEE 

RECEIVED DAT.A. This lead 
carries the serial digital data re- 
ceived at the DE: 


REQUEST 1O SEND. An ON: 
condition on this lead 15 used to 
enable the local DCE for data tran- 
smission. 


(CLEAR TO SEND An OS” 
condition on this lead indicates 
whether or not the DCE is ready to 
transmit data. 


DATA SET READY. An “ON” 
condition on this lead indicates that 
the local DCE is ready to process 
data and is not in a test, talk, or dial 
mode. 


Source: Couch, L. W., Digital and Analog Communication Systems, Macmillan Pub- 
lishing Company, 1987, pp. 684-686 
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Table 17. RS-232C INTERFACE PIN CONNECTIONS (CONTINUED) 


Pin Circuit ane 
Number Desig- Desig- Direction Description 
| nation 


SIGNAL GROUND. This lead es- 
tablishes the common ground refer- 
ence potential for all circuits except 
frame ground on pin 1. 


DATA CARRIER DETECT (Re- 
ceived Line Signal Detector). This 
lead indicates that data from the 
remote location is being received 
and meets a suitable criterion es- 
tablished by the DCE manufac- 
turer. 


Positive DC Test Voltage 
Negative DC Test Voltage 
EQUALIZER MODE. This lead is 


used to indicate to the DTE that the 
type cir- adaptive equalizer in the receiver is 
cuit reset automatically when error per- 
formance is poor. (non-EIA desig- 
nated). 


(SjDCE SECONDARY DATA CARRIER 
DETECT. This lead is equivalent 
to DCD on pin 8 except that it in- 
dicates the proper reception of the 
secondary channel line signal in- 
stead of the primary channel re- 
ceived line signal. 

SCB (S)CTS To DTE | SECONDARY CLEAR TO SEND. 
This lead is equivalent to CTS on 
pin 5 except that it indicates the 
availability of the secondary chan- 
nel instead of indicating the avail- 
ability of the primary channel to 
transmit data. 





Source: Couch, L. W., Digital and Analog Communication Systems, Macmillan Pub- 
lishing Company, 1987, pp. 684-686 
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Table 18. 


Mne- 
monic 
Desig- 
nation 


Circuit 
Desig- 
nation 


Pin 
Number 


14 


Bell 
208A 
type cir- 
cuit 


To DCE 


Toser 


| E 


SBB 


Bell 
208A 
туре cir- 
cuit 


(S)RD To IDHE 
De 


To DTE 


RS-232C INTERFACE PIN CONNECTIONS (CONTINUED) 


Description 


SECONDARY TRANSMITTED 
DATA. This lead is equivalent to 
TD on pin 2 except that it is used 
to transmit data via the secondary 
channel. 


NEW SYNC. This lead may be 
used on an optional basis with the 
DCE at а master station of a mul- 
tistation private line network, such 
as in a polling operation. to ensure 
rapid resynchronization of the re- 
ceiver on data from many different 
remote transmitters (non-ELA des- 
ignated). 

TRASS DER CLOC. ws 
lead is used to provide the DTE 
with signal element tinung informa 
поп. 

SECONDARY RECEIVED 
DATA. This lead is equivalent to 
RD on pin 3 except that it is used 
to receive data on the secondary 
channel. 


DIVIDED CLOCK, TRANSMIT- 
TER. A square-wave signal at 
one-third the nominal bit rate ap- 
pears on this lead whenever power 
is supplied to the DCE (non-EIA 
designated.). 





Source: Couch, L. W., Digital and Analog Communication Systems, Macmillan Pub- 


lishing Company, 1987, pp. 684-686 


Table 19. 


Pin 
Number 


RS-232C INTERFACE PIN CONNECTIONS (CONTINUED) 


Circuit 
Desig- 
nation 


To DTE 


To DIE 


Bell 
208A 
type cir- 
cuit 


(S)RTS To DCE 
To DCE 


Description 


RECEIVER CLOCK. This lead is 
used to provide the DTE with re- 
ceived signal element timing infor- 
mation. 


DIVIDED CLOCK, RECEIVER. 
A square-wave signal on this lead 
provides the receiver timing infor- 
mation at one-third the nominal bit 
rate (non-EIA designated). 


SEGO.DARY REQUEST TO 
SEND. This lead is equivalent to 
RTS on pin 4 except that it requests 
to use the secondary channel in- 
stead of the primary data channel. 


DATA TERMINAL READY. An 
“ON” condiuon on this lead indi- 
cates that the ОТЕ is ready to be 
connected to the communication 
channel. 

SOS A ОЕК ТҮ ӨБҮП 
This lead is used to indicate whether 
or not there is a high probability of 
an error in the received data. 





Source: Couch. L. W.. Digital and Analog Communication. Systems, Macmillan Pub- 
lishing Company, 1987, pp. 684-686 
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Table 20. RS-232C INTERFACE PIN CONNECTIONS (CONTINUED) 


Circuit E 

Desig- Desi Direction Description 
; esig- 

nation 


RING INDICATOR. An "ON" 
condition on this lead indicates that 
a ringing signal is being received on 
the communication channel. 
DATA RATE SELECTOR. This 
lead is used to select between the 


two data signalling rates in the case 
of dual rate DCE. 


DATA RATE SELECTOR. This 
lead is used to select between the 
two data signalling rates in the case 
of dual rate DCE. 


ЕЛЕК ХОШ ПЕМ ОИТТЕК 
CLOCK. This lead is used to pro- 
vide the transmitting signal con- 
verter with signal element timing 
information. 


BUSY. This lead is used for testing 
purposes by Telephone Company 
type cir- personnel (non-EIA designated). 
cuit 





Source: Couch. L. W., Digital and Analog Communication Systems, Macmillan Pub- 
lishing Company, 1987, pp. 684-686 
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